๐Ÿ”— API Patterns and Practices: gRPC
Chapters Examples Bibliography GitHub โ†—
Home / Schema Evolution & the Living Contract
Part 5 2 chapters

Schema Evolution & the Living Contract

Design and evolve a proto without breaking clients, enforced by CI.

Chapter 13

Schema design over gRPC

Message granularity, request and response envelopes, pagination with page tokens, and FieldMask projection.

22 min readRead โ†’
Chapter 14

Evolution and versioning

Field numbers as the contract, reserved, backward/forward compatibility, package versioning from shipping.routing.v1 to v2, the buf breaking gate with a deliberate-drift test, and the Buf Schema Registry.

24 min readRead โ†’
โ† Previous part Reliability: Deadlines, Errors & Interceptors Next part โ†’ Concurrency & Long-Running Work

API Patterns and Practices: gRPC

Designing gRPC APIs well, with runnable examples in Quarkus and Python against one Protobuf contract.

Site

  • Outline
  • Bibliography

Reference

  • Protocol Buffers โ†—
  • Buf โ†—
  • gRPC docs โ†—
  • View on GitHub โ†—
  • Issues โ†—
Open source ยท MIT Last built 2026-10-17