Five Principles of Web API Design

#64 - Principles for Designing Successful Web APIs - James Higginbotham

Topic 3 of 7

Published Nov 15, 2021 · Clip 13:14–31:47 (18:34)

The conversation walks through key API design principles from the book. Principle one: never design APIs in isolation — involve subject matter experts from product, security, and UX. Principle two: start with an outcome-based focus using jobs-to-be-done and job stories (When/I Want To/So I Can). Principle three: select API design elements and styles (REST, GraphQL, gRPC, webhooks) that match consumer needs, mixing and matching as appropriate. Principle four: API documentation is the most important UI for developers, including reference docs, getting started guides, and cookbooks. Principle five: APIs are forever — plan for versioning and avoid breaking changes to prevent customer churn.