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
Learn how to work with a powerful API mocking tool: Microcks, and how to integrate it with your existing API documentation flow.
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
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
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
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
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
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
Master the use of $ref in OpenAPI and AsyncAPI to manage complex YAML/JSON documents, reduce merge conflicts, and streamline your API descriptions.
codegen
Generate TypeScript client code easily with Fern, an automated tool that builds SDKs for major languages, Postman Collections, and OpenAPI definitions. Avoid the slow and brittle manual process, and publish directly to package repositories like NPM.
api-design
When rewriting an API, it's critical to make sure you don't change the shape of your inputs and outputs unexpectedly. After all, API specs are called contracts for a reason. This article outlines an approach to capturing API traffic using Optic for just this purpose.
openapi
Capture real HTTP traffic from production or anywhere else, and create OpenAPI from it, for documentation, mocks, SDKs, or contract testing.