API Contract Design

Overview

Define the API contract before implementing frontend or backend. Contract-first development prevents integration surprises.

Core principle: The API contract is the agreement between frontend and backend. Change it deliberately, never accidentally.

When to Use

• Starting a new feature that spans frontend and backend
• Frontend and backend developed in parallel
• Changing existing API endpoints
• Detecting or preventing breaking changes

Contract-First Workflow