
API Design-First and the ADDR Process

#64 - Principles for Designing Successful Web APIs - James Higginbotham
Topic 4 of 7
Published Nov 15, 2021 · Clip 31:47–38:56 (7:09)
James advocates the API design-first approach, balancing upfront lightweight design with agile delivery to avoid writing code that misses the mark. He introduces the ADDR (Align-Define-Design-Refine) process: Align using job stories and step-by-step activities, Define API boundaries and operations independent of style, Design by applying one or more API styles and producing specs like OpenAPI or GraphQL SDL, and Refine using mocks and socialization for rapid feedback. The host notes the approach also speeds parallel development across geographically dispersed teams.