OpenAPI v3.1 Resources for Tooling DevelopersOpenAPI v3.1.0 has a bunch of great changes, solving problems like the subtle differences between JSON Schema objects and OpenAPI Schema…
Creating OpenAPI from HTTP TrafficAround this time of year we’re thinking about things we’re going to do differently, new practices we’ve been putting off for too long, and…
OpenAPI Examples Need HelpOpenAPI has come a long way since its nascent days as Swagger. It’s got excellent tooling, is talked about at all the conferences, is used…
Update on OpenAPI and JSON SchemaUpdate 2020-02-02: JSON Schema Draft 2019-09 has been published for a while, and after much deliberation we got the folks at OpenAPI to…
Reinventing API Design with Stoplight StudioTwo months ago I teased that Stoplight was about to release something big, and yesterday we announced Stoplight Studio - an OpenAPI and…
Solving OpenAPI and JSON Schema DivergenceUpdate 2020-02-02: This article has been replaced entirely, as the proposed workaround was written into a now abandoned project Speccy, and…
OpenAPI and JSON Schema Divergence: Part 1This article is going to explain the divergence between OpenAPI and JSON Schema, which I’ve been calling the subset/superset/sideset problem…
Design-first API Specification Workflow MaturesBack in October I wrote Chasing the Perfect API Specification Workflow, which was a huge article about the state of the API specification…
One Month Since OpenAPI v3.0Last month today OpenAPI v3.0 was released, and not only is there a lot of cool stuff, but it unblocks some akward situations with vendor…
Chasing the Perfect API Specification WorkflowDocumentation is a nice thing to have, but it is often treated as optional or superfluous, especially in teams where the clients and servers…