openapi
JSON Streaming in OpenAPI v3.2
Let's have a look at how the upcoming OpenAPI v3.2 is going to help describe JSON Streaming, and in the process learn more about what the heck that 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.
openapi
Utilize AI for API Governance with LintGPT
LintGPT from Optic is the latest way to automate your API Style Guides, combining API Linting with ChatGPT in a way that's not just buzzword nonsense.
openapi
OpenAPI & AsyncAPI $ref: Advanced Guide
Master the use of $ref in OpenAPI and AsyncAPI to manage complex YAML/JSON documents, reduce merge conflicts, and streamline your API descriptions.