🔌API-First Design
Also known as API-First, API First, Design-First API, Contract-First
Plan the API first. Then write the code behind it.
Think of it like
Think of it like drawing a house plan first. Everyone agrees on the rooms before work starts.
Example
Emma's team writes the orders API in OpenAPI first. The app team builds against a mock while the server team builds the real thing.
Why it matters
Teams work at the same time instead of waiting on each other.
Definition
Common mistake
Key takeaways
- 1Spec first. Write the API before the code.
- 2Agree early. All teams sign off the shape.
- 3Build in parallel. Mocks stand in meanwhile.