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.
Phil Sturgeon
Co-founder of APIs You Won't Hate, and part techie, part woodland creation, and ancient woodland restoration. Co-founder of @ProtectEarthUK. @philsturgeon@mastodon.green
api-design
The "Don't Have Time to Create API Documentation" Paradox
Instead of rushing out a barely planned API and forgetting how it works in the flurry of changes that follow, you can document it before you build to keep everyone on the same page.
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.
http
Powerful HTTP/API Clients: Alternatives to Postman
A comparison of quick and easy graphical HTTP clients you can use if you're considering alternatives to Postman.
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.
API Design Basics: Resources & Collections
Learn how to use resources and collections for a REST API, getting stuck into some real world examples, using links to get between them all, and some pitfalls to avoid.
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.
api-design
API Design Basics: Pagination
How to handle pagination in your REST API, and what are the pros and cons of each method?
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?
api-design
API Code-first: How to Generate OpenAPI from Code
An update on the API Code first or Design first debate, with some modern tools making a slightly nicer version of the Code first workflow, and better modern design first tooling.