Mar 2026 · Engineering · 8 min

Designing APIs for Humans

An API is a user interface for developers. If it needs explanation every time, the design is wrong.

Use stable nouns for resources, predictable verbs for actions, and explicit status/error formats for every response path.

Optimize for integration speed: sensible defaults, small payloads, and examples that match production behavior.