openapi
OpenAPI Format: A GUI for Overlays
Overlays can be tricky to wrap your head around, but this handy GUI can help it all make sense.
geojson
Stream GeoJSON in a HTTP/REST API
Once you've learned the basics of JSON Streaming in APIs, it starts to become a whole lot more interesting for a whole lot more use-cases.
openapi
JSON Streaming in OpenAPI v3.2
Learn how OpenAPI v3.2 helps describe JSON Streaming, and in the process find out more about what the heck JSON streaming even is.
openapi
Learn OpenAPI from these Realistic Examples
If you prefer to learn by looking at examples, maybe a cheeky bit of copy-paste coding, these OpenAPI examples can get you started.
openapi
The OpenAPI Discriminator is Redundant & Confusing
A quick look at why OpenAPI's "discriminator" keyword is an outdated concept that you can probably skip worrying about learning.
openapi
Introducing Arazzo: Describe API Workflows with this extension to OpenAPI
A new specification from the OpenAPI Initiative to handle describing workflows, to make more powerful documentation, and functional/end-to-end testing. Sponsored by Bump.sh.
openapi
Mocking APIs with Microcks
Learn how to work with a powerful API mocking tool: Microcks, and how to integrate it with your existing API documentation flow.
openapi
Documenting PHP APIs with OpenAPI
Over on Bump.sh I’ve been writing infinite guides helping people learn how to get OpenAPI out of (or into) their various programming languages and web frameworks, and I wanted to share a summary of that work for the PHP crowd over here with some links.
openapi
How to use JSONPath with OpenAPI
JSONPath is a query language that can be used to extract data from JSON documents, and it's becoming increasingly useful in the OpenAPI ecosystem.
openapi
OpenAPI v4.0 (A.K.A "Project Moonwalk")
What is coming next for OpenAPI, as v4.0 of the OpenAPI Specification gets closer to being released? What changes are coming, how easy will it be to upgrade, and how do tooling companies feel about it?
openapi
Use OpenAPI Overlays Today
Overlays are a way to "patch" an OpenAPI document, by pointing to a specific part of it with a JSONPath, then using "actions" to update or remove parts of the document. Can this help you?
api-design
How to Build a Perfect API Description
Learn what best practices and tooling you can use to build the best quality OpenAPI documentation from somebody who has been doing it forever.