API Design: REST, GraphQL & gRPC

Resource modeling, HTTP semantics, problem+json errors, cursor pagination, idempotency keys, ETags, bulk operations, GraphQL (DataLoader, cost limits, persisted queries), gRPC (protobuf, deadlines, streaming) and how to choose between them.

About 100 minutes · 15 exam questions · 8 interview questions · 2 code labs

What you will learn

  1. Resource modeling and the Richardson Maturity Model
  2. HTTP semantics: methods, idempotency and status codes
  3. Error model: RFC 9457 problem details
  4. Collections: pagination (offset vs cursor), filtering and sorting
  5. Idempotency keys for POST
  6. ETags and conditional requests
  7. Bulk APIs and partial failures
  8. GraphQL: schema design, N+1 and DataLoader, cost limits, persisted queries
  9. gRPC: protobuf, HTTP/2, deadlines and streaming
  10. Choosing a format: the ADR, BFFs and multiple specifications
  11. Performance at the API layer: payload size, compression, round trips
  12. Scenario playbook

Next: API Versioning, Contracts & Testing