๐Ÿ”Œ API Patterns and Practices: REST
Chapters Examples Bibliography GitHub โ†—
Home / HTTP semantics done right
Part 3 2 chapters

HTTP semantics done right

Return correct status codes, headers and representations, and do partial updates two correct ways: JSON Patch and Merge Patch.

Chapter 6

Content negotiation & status codes

Serve the right representation for the client's Accept, reject the wrong Content-Type, and return status codes that mean exactly what the spec says โ€” 406, 415, and the 2xx/4xx/409 set.

28 minRead โ†’
Chapter 7

Partial updates: JSON Patch vs Merge Patch

Two correct ways to change part of a resource โ€” RFC 6902 JSON Patch and RFC 7396 JSON Merge Patch โ€” their media types, their trade-offs, and when each one is the right tool.

28 minRead โ†’
โ† Previous part Designing resources with a contract Next part โ†’ Collections at scale

API Patterns and Practices: REST

Designing REST APIs well, with runnable examples in Quarkus and Python/FastAPI.

Site

  • Outline
  • Build & iteration plan
  • Coverage matrix
  • Domain glossary
  • Bibliography

Reference

  • OpenAPI 3.1 โ†—
  • AsyncAPI 3 โ†—
  • View on GitHub โ†—
  • Issues โ†—
Open source ยท MIT Last built 2026-10-17