Books for API Developers
Build APIs You Won't Hate
Everyone and their dog wants an API, so you should probably learn how to build them.
More API goodness
Creating OpenAPI from HTTP Traffic
Jan 01, 2022
If you want to get into API design-first, but awkwardly already have a bunch of APIs with no OpenAPI, use a HTTP proxy like Akita to create OpenAPI from your HTTP traffic!
JSON Schema Bundling Finally Formalised
Aug 04, 2021
Existing tooling developers have created their own approaches to bundling JSON Schema and OpenAPI documents, but that can lead to errors. Bundling is now standardised.
Why Show Users Garbage API Errors?
May 14, 2021
What happens in your client application when an API error pops up beyond the common cases of Logged Out, Not Found, etc.? Do you vomit random API error codes and exception class names all over your end users screens, pointlessly confusing the hell out of them?
There's No Reason to Write OpenAPI By Hand
Mar 30, 2020
Sometimes you see people complaining about OpenAPI (formerly Swagger), saying they don't want to to write out a whole bunch of YAML/JSON by hand. Other than disability, there's no reason you need to do that, and there hasn't be for a long time. Whether you pick code-first or design-first, you've got some options.
OpenAPI v3.1 and JSON Schema
Feb 03, 2020
JSON Schema and OpenAPI will no longer have minor differences in the schema object, but will finally be compatible from OpenAPI v3.1.
Easy to Follow Hypermedia Controls with Ketting
Nov 22, 2019
Automated Style Guides for REST, GraphQL and gRPC
Nov 05, 2019
Create API style guides using linting tools for any API paradigm. Avoid "API Governance" teams sitting there reviewing every single API change that comes through, and automate that menial task away to the bots.
OpenAPI Callbacks and Webhooks
Oct 24, 2019
What's the difference between a callback and a webhook, and which does OpenAPI support? Read on to find out the current status and upcoming changes for asynchronous and two-way APIs.
API Design-First vs Code First
Oct 14, 2019
With API descriptions rising in popularity, the main question I hear folks asking about is "API Design-first" or "code-first". This is a bit of a misleading question because these are not two unique things, there are a few variants.
GraphQL & Caching: The Elephant in the Room
Jun 25, 2019
Bringing nuance to the polarized subject of caching in GraphQL.
Testing API Client Applications
Jun 09, 2019
Got some code that talks to a Web API and want to make sure it works properly? Here's a bunch of options you can use to mock external dependencies.