๐Ÿ”Œ API Patterns and Practices: REST
Chapters Examples Bibliography GitHub โ†—
Home / Multi-protocol contracts & framework deep-dives
Part 9 4 chapters

Multi-protocol contracts & framework deep-dives

Go deep on OpenAPI, pair it with AsyncAPI, CloudEvents, and Arazzo under one shared schema, then dig into Quarkus REST and FastAPI internals.

Chapter 20

OpenAPI in depth

Full JSON Schema alignment in a served OpenAPI document โ€” type-array nullable, top-level webhooks โ€” and the living-contract drift check that keeps a generated doc matching the shared schema.

28 minRead โ†’
Chapter 21

Multi-protocol contracts

How OpenAPI, AsyncAPI, CloudEvents, and Arazzo compose around one domain through a single shared JSON Schema, with Apicurio Registry and OpenMetadata shown as the governance tier behind that schema reuse.

30 minRead โ†’
Chapter 22

Quarkus REST in depth

Why Quarkus REST resolves parameter bindings at build time instead of by reflection, how that shows up in @RestHeader/@RestQuery, and why reactive Multi streaming needs its own NDJSON writer to avoid double-encoding.

27 minRead โ†’
Chapter 23

FastAPI in depth

Why async def handlers run on FastAPI's event loop while plain def handlers get offloaded to a threadpool, and how StreamingResponse and BackgroundTasks each depend on that same ASGI dispatch model.

26 minRead โ†’
โ† Previous part Performance & transport Next part โ†’ Testing

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