THE API DESIGN BLOG

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

Subscribe
Export API Documentation as a PDF

Using OpenAPI to create PDF based reference documentation for clients and other third-parties.

Read
Phil Sturgeon
Jan 4, 2021
Deprecating API Endpoints

How do you warn API consumers developers when an API or endpoint is going away?

Read
Phil Sturgeon
Dec 4, 2020
Generating API Documentation from Code with Stoplight

Regardless of whether you use code-first or design-first, Stoplight is here to help.

Read
Phil Sturgeon
Oct 6, 2020
Introducing Stoplight's New CEO

Stoplight's rapid growth has given us the exciting opportunity to more broadly tackle the end-to-end API lifecycle.

Read
Marc MacLeod
Aug 3, 2020
Just a Simple API: List of APIs with Fun Data for Quick Mock-ups

Todos, Entertainment, and APIs That Are Out of This World (Literally)

Read
Luke Russell
Jul 8, 2020
Rethinking API Design at Scale with the Stoplight Platform
Read
Marc MacLeod
Jun 25, 2020
API Design-First vs Code First

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 ...

Read
Phil Sturgeon
Apr 8, 2020
Keeping OpenAPI DRY and Portable

Bundling, dereferencing, and how to use them in Stoplight Studio and CLI workflows.

Read
Phil Sturgeon
Mar 11, 2020
Open Source Mock Server Gets Smarter

Stoplight's Prism supports callbacks, proxies, and even more validations.

Read
Vincenzo Chianese
Feb 4, 2020
Mocking Callbacks with OpenAPI and Prism

What are callback, why use them, and how to set them up using OpenAPI and Prism.

Read
Karol Maciaszek
Dec 12, 2019