Bagaimana komponen berkomunikasi dalam sebuah sistem (APIs)?

Question

Accepted Answer

Dalam sebuah sistem, komponen (service, klien) berkomunikasi melalui **APIs** dan berbagai protokol — sinkron (REST, gRPC) dan asinkron (messaging/queue). Memahami cara komponen berkomunikasi adalah fundamental dalam merancang sistem yang terdiri dari banyak bagian.

## Komunikasi sinkron (request/response)

```text
The caller WAITS for a response (blocking):
  REST (HTTP) → most common; resources over HTTP (JSON) → simple, ubiquitous, web-friendly
  gRPC → high-performance RPC (binary, HTTP/2) → fast, typed; good for internal services
  GraphQL → flexible queries (client requests exactly what it needs)
→ for: direct request/response where the caller needs an answer now
```

## Komunikasi asinkron (messaging)

```text
The caller does NOT wait (decoupled, non-blocking):
  MESSAGE QUEUES (RabbitMQ, SQS) → send a message; a consumer processes it later
  EVENT STREAMING (Kafka) → publish events; consumers react
  PUB/SUB → broadcast events to subscribers
→ for: decoupling, background work, handling spikes, event-driven systems
  ✓ resilience (queue buffers), scalability, decoupling  ✗ more complexity, eventual consistency
```

## Memilih dan pertimbangan

```text
SYNC → when the caller needs an immediate response; simpler request/response
ASYNC → when decoupling, resilience, or background processing matters (don't block)
→ Also: API design (clear contracts), versioning, error handling, timeouts/retries,
  authentication, rate limiting → robust communication between components
```

## Mengapa ini penting

Memahami cara komponen berkomunikasi melalui APIs adalah fundamental karena **sistem terdiri dari banyak bagian yang harus berkomunikasi**, sehingga memahami komunikasi adalah penting untuk merancangnya.

Sistem terdiri dari service dan klien yang berinteraksi, dan cara mereka berkomunikasi adalah aspek fundamental dari desain sistem.

Memahami **komunikasi sinkron** (request/response di mana pemanggil menunggu) — **REST** (pendekatan HTTP/JSON yang ubiquitous), **gRPC** (RPC berperforma tinggi untuk service internal), dan GraphQL (query fleksibel) — mencakup cara umum komponen melakukan panggilan langsung yang mengharapkan jawaban.

Memahami **komunikasi asinkron** (decoupled, non-blocking) — **message queue** (mengirim pesan untuk pemrosesan nanti), **event streaming** (Kafka), dan pub/sub — sama pentingnya, karena memungkinkan **decoupling, resilience (queue mem-buffer beban), skalabilitas, dan sistem event-driven**, dengan biaya kompleksitas lebih tinggi dan eventual consistency.

Memahami **perbedaan sinkron vs asinkron dan kapan menggunakan masing-masing** — sinkron ketika pemanggil memerlukan respons segera, asinkron ketika decoupling, resilience, atau background processing penting — adalah pertimbangan desain kunci yang secara signifikan mempengaruhi karakteristik sistem.

Memahami pertimbangan tambahan (API contract yang jelas, versioning, error handling, timeout/retry, authentication, rate limiting) mencerminkan merancang komunikasi yang robust.

Karena sistem terdiri dari bagian-bagian yang berkomunikasi dan cara mereka berkomunikasi (sinkron vs asinkron, protokol, dan pertimbangan desain) secara fundamental membentuk sistem, dan karena memahami komunikasi komponen adalah penting untuk merancang sistem multi-komponen, memahami cara komponen berkomunikasi melalui APIs adalah pengetahuan desain sistem yang penting dan fundamental — fundamental untuk merancang sistem yang terdiri dari banyak bagian yang saling berinteraksi, mencakup komunikasi sinkron dan asinkron yang menghubungkan komponen, dan sentral untuk mengarsitektur sistem berbasis service terdistribusi yang umum saat ini.