API Design

Purpose

Design HTTP APIs that clients can use correctly without reading your source code, and that you can evolve without breaking them.

When to Use

• Designing a new API or a new endpoint on an existing one.
• Reviewing an API before it becomes public and therefore permanent.
• Introducing versioning, pagination, or idempotency to an API that lacks them.
• Writing or auditing an OpenAPI specification.

Capabilities