APIs You Won't Hate

Featured Article

Eight of the Biggest Lies in APIs

written by Matthew Reinbold

In the API space, numerous statements are context-dependent, misunderstandings, or outright lies. Here are some of the biggest the APIs You Won't Hate community has heard to date.

Read more →
Eight of the Biggest Lies in APIs

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.

Get the book
Cover image for Build APIs You Won't Hate

Surviving Other People's APIs

Designing the world's most beautiful API is only half the story, somebody needs to interact with it!

Cover image for Surviving Other People's APIs

More API goodness

Creating OpenAPI from HTTP Traffic

Creating OpenAPI from HTTP Traffic

Phil Sturgeon

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

JSON Schema Bundling Finally Formalised

Ben Hutton

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?

Why Show Users Garbage API Errors?

Phil Sturgeon

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

There's No Reason to Write OpenAPI By Hand

Phil Sturgeon

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

OpenAPI v3.1 and JSON Schema

Phil Sturgeon

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

Easy to Follow Hypermedia Controls with Ketting

Evert Pot

Nov 22, 2019

The Ketting library is a generic hypermedia client written in JavaScript. It supports an opinionated set of modern features REST services might have, including HAL, JSON:API, Web Linking (HTTP Link Header) and HTML5 links. Ketting v5.0 just released with support for Siren and other neat new features.

Automated Style Guides for REST, GraphQL and gRPC

Automated Style Guides for REST, GraphQL and gRPC

Phil Sturgeon

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

OpenAPI Callbacks and Webhooks

Lorna Mitchell

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

API Design-First vs Code First

Phil Sturgeon

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

GraphQL & Caching: The Elephant in the Room

Marc-Andre Giroux

Jun 25, 2019

Bringing nuance to the polarized subject of caching in GraphQL.

Testing API Client Applications

Testing API Client Applications

Phil Sturgeon

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.

Read more articles →

APIs You Won't Hate

BooksBlogVideosPodcastAsk us a question

Subscribe to our newsletter

Powered by Vercel

© 2022 APIs You Won't Hate. All rights reserved.