api-governance
Breaking Change Detection in OpenAPI
A look at several approaches you can take to help stop breaking changes from sneaking up on you, using OpenAPI Tooling
api-governance
OpenLint: picking up where Spectral left off
In an age of relentless slop, it's never been more important to protect your API ecosystems with automated style guides, and whilst Spectral has slowed down, OpenLint is about to hit the ground running.
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?