Explorations and explanations of OpenAPI and JSON Schema from a co-author of the specifications.
Welcome to a new series of posts that will take you on a visual journey through the OpenAPI Specification (OAS) and its tooling ecosystem! Why diagram the OAS ecosystem? As part of the efforts to design OAS 3.2 and 4.0 “Moonwalk”, I wanted to figure ...
The most popular version of the OpenAPI Specification (OAS) as of early 2024 is OAS 3.0. While adoption of OAS 3.1 is gaining steam, users whose needs are met by 3.0 or who want to wait for 3.1 support to mature are in no hurry to update. But softwar...
Sometimes you start a blog and right as you're getting going, life gets complicated. 2023 involved a lot of changes for me, including a shift in focus from the JSON Schema specification to the OpenAPI Initiative (not to be confused with OpenAI!). It'...
Did you come to JSON Schema with an object-oriented programming (OOP) background? Do think of writing a schema as analogous to writing a class? These expectations are both common and understandable, but incorrect. In this article, you'll learn: What...
Welcome to the Modern JSON Schema (& APIs) blog! My name is Henry, and I'm the H. Andrews who co-authored all drafts of JSON Schema from 2017 to the present. With this blog, I want to help you use JSON Schema to the full extent of its capabilities!...