Api Design

Solid reference for REST API conventions that covers the fundamentals without overcomplicating things. You get practical guidance on resource naming (plural nouns, kebab-case), proper HTTP status code usage, and pagination strategies with concrete tradeoffs between offset and cursor-based approaches. The error response formats and filtering syntax examples are especially useful when you're trying to maintain consistency across endpoints. It leans opinionated on some choices like response envelopes, but that's actually helpful when you're designing from scratch. Best used when starting a new API or during code review to catch common mistakes like returning 200 for everything or using verbs in URLs.