๐Ÿ”Œ API Patterns and Practices: REST
Chapters Examples Bibliography GitHub โ†—
Home / Collections at scale
Part 4 2 chapters

Collections at scale

Design collection endpoints that stay fast and safe under load, and choose a pagination strategy on purpose.

Chapter 8

Filtering, projection & pagination

Keep collection endpoints fast and safe under load: filter and project fields, choose the right pagination strategy among offset, keyset, and seek, and cap limit as a denial-of-service guard.

30 minRead โ†’
Chapter 9

Sub-resources

When nesting a resource under a parent expresses real ownership โ€” and when it's a trap: the caching cost of nesting, the redundant-endpoint pitfall, and how to decide.

22 minRead โ†’
โ† Previous part HTTP semantics done right Next part โ†’ Asynchronous work & jobs

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