APIs You Won't Hate

Featured Article

Testing Spectral Style Guides with Jest

written by Phil Sturgeon

Make sure your automated API style guide actually works, and doesn't break as you improve it over time.

Read more →
Testing Spectral Style Guides with Jest

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

Distribute Spectral Style Guides with NPM

Distribute Spectral Style Guides with NPM

Phil Sturgeon

Jun 28, 2022

Creating an API style guide for your whole organization is only useful if your whole organization can access it, so lets see how distributing via npm can help.

The Best Content to Supplement Your API Documentation

The Best Content to Supplement Your API Documentation

Karl Hughes

May 17, 2022

While having accurate, up-to-date documentation is vital, it’s not enough. Creating content to support your documentation is a great way to help users solve their own problems and get started faster.

Modern API Deployment Options in the Cloud

Modern API Deployment Options in the Cloud

Alexander Karan

May 04, 2022

Creating an API for your backend doesn't need to be complicated. Let's explore some options for bootstrapping an API using modern tools.

Contract Testing a Laravel API with OpenAPI

Contract Testing a Laravel API with OpenAPI

Phil Sturgeon

Feb 04, 2022

Keeping your API and OpenAPI in sync doesn't have to be complicated, the Laravel PHP edition.

Eight of the Biggest Lies in APIs

Eight of the Biggest Lies in APIs

Matthew Reinbold

Jan 12, 2022

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.

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.

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.