bigonotes
System DesignAPI Design

API Design

REST, pagination, versioning, status codes and API security.

5 notes · 19 min total

  1. 1API Design FundamentalsAudioChoosing between REST, GraphQL and RPC, plus the core API design checklist: resources, methods, pagination, versioning and security.3 min
  2. 2RESTModel resources from your core entities, use HTTP methods correctly, and pass data via path, query and body.3 min
  3. 3Pagination and VersioningOffset vs cursor pagination, URL vs header versioning, and how to retire old API versions without breaking clients.6 min
  4. 4Security ConsiderationsAuthentication vs authorization, when to use API keys or JWTs, role-based access control, and rate limiting for APIs.5 min
  5. 5HTTP Status CodesThe HTTP status codes you'll actually use in API design, grouped by class, with what triggers each.2 min