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
Stoplight Studio Desktop v2.1 Released

Generate Schemas from JSON, Custom Table of Contents, and Performance Improvements.

Read
Phil Sturgeon
Oct 27, 2020
How OpenAPI Data Types Enable Robust APIs

How JSON and JSON Schema impacted the OpenAPI format and what’s possible with your API descriptions.

Read
Adam DuVander
Oct 12, 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
What's the Difference Between OpenAPI 2.0, 3.0, and 3.1?

Let's look at some of the key differences between OpenAPI 2.0, 3.0, and 3.1.

Read
Janet Wagner
Sep 29, 2020
New Features in Stoplight Platform and Studio

Workspaces, Automatic Publishing, Theming, and multiple branches in documentation.

Read
Phil Sturgeon
Sep 9, 2020
Is API Planning the Same Thing as API Design?

Exploring the stages that make up the API planning process for code-first and design-first teams.

Read
Phil Sturgeon
Aug 10, 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
Introduction to API Testing

Where does integration testing, contract testing, or performance testing fit in with APIs?

Read
Phil Sturgeon
Jul 10, 2020