The API Design Blog

The #1 source of tips and tricks for building quality APIs with a Design-First Approach

OpenAPI and JSON Schema: When to Use Which

Behind the divergence in data formats and how you can solve it

Kyle Lange
Kyle Lange
October 16 2019

Why You Shouldn't Ignore Internal API Documentation

Enable your teams to move faster and collaborate efficiently

Adam DuVander
Adam DuVander
September 25 2019

Prism v3 Adds OpenAPI 3.0 and Goes Open Source

Prism now has a version 3: it's open source, faster, has OpenAPI 3 support, and ...

Vincenzo Chianese
Vincenzo Chianese
July 16 2019

More Flexible JSON Linting with Spectral 4.0

Ruleset improvements and more CLI focus provide a better experience

Taylor Barnett
Taylor Barnett
July 11 2019

REST API Security Design

Implementing design-time security definitions using OpenAPI

Chris Wood
Chris Wood
July 3 2019

Don’t Waste Your Time Building Fake APIs in Code

Compare OpenAPI mock servers to writing Java, PHP, and C#

Kyle Lange
Kyle Lange
June 20 2019

A Simple API Design Walkthrough

How to prototype an API before you code

Adam DuVander
Adam DuVander
June 13 2019

Reusing Definitions Across Methods in OpenAPI

Bring schemas into your API descriptions and don’t repeat yourself

Chris Wood
Chris Wood
May 8 2019

Build a Python REST API Server for Quick Mocking

Use Flask or Falcon to serve API requests

Adam DuVander
Adam DuVander
April 30 2019

CRUD API Design & CRUD API Recommendations

When and how it makes sense to create, read, update, and delete in your API

Lukas Rosenstock
Lukas Rosenstock
April 24 2019
Peek-a-Boo

Subscribe for the latest in API Design

By submitting this you will be receiving our latest updates on post.

Take a Listen to API Intersection

The podcast on the intersection between API design & digital transformation
Listen