System Design · Communication & APIs
Communication & APIs
How components talk to each other and to the outside world.
01
Chapter One
Synchronous vs Asynchronous Communication
The Fundamental Communication Choice
Coming Soon
Synchronous vs Asynchronous Communication
This chapter establishes the fundamental choice between synchronous and asynchronous communication and when each is appropriate.
📋 Chapter 1 — Summary
- Summary content pending.
02
Chapter Two
REST — Deep Dive
The Protocol That Runs the Web
Coming Soon
REST — Deep Dive
This chapter covers REST constraints, HTTP semantics, the Richardson maturity model, and how to version APIs without breaking clients.
📋 Chapter 2 — Summary
- Summary content pending.
03
Chapter Three
gRPC & Protocol Buffers
When REST Isn't Fast Enough
Coming Soon
gRPC & Protocol Buffers
This chapter covers Protocol Buffers, gRPC streaming modes, and when to use gRPC over REST for internal service communication.
📋 Chapter 3 — Summary
- Summary content pending.
04
Chapter Four
GraphQL
Client-Specified Queries and the N+1 Problem
Coming Soon
GraphQL
This chapter covers GraphQL schema design, the N+1 query problem, DataLoader batching, and when GraphQL is worth its complexity.
📋 Chapter 4 — Summary
- Summary content pending.
05
Chapter Five
WebSockets & Server-Sent Events
Persistent Connections for Real-Time Data
Coming Soon
WebSockets & Server-Sent Events
This chapter covers WebSockets, SSE, and long polling for real-time communication, with decision guidance on when to use each.
📋 Chapter 5 — Summary
- Summary content pending.
06
Chapter Six
Event-Driven Architecture
Systems That React Instead of Ask
Coming Soon
Event-Driven Architecture
This chapter covers event-driven patterns, choreography vs orchestration, CQRS, and the outbox pattern for reliable event publishing.
📋 Chapter 6 — Summary
- Summary content pending.
07
Chapter Seven
API Design Best Practices
APIs as Long-Lived Public Contracts
Coming Soon
API Design Best Practices
This chapter covers idempotency, pagination, error handling, deprecation strategy, and security for APIs designed to last years.
📋 Chapter 7 — Summary
- Summary content pending.