Como componentes se comunicam em um sistema (APIs)?

Question

Accepted Answer

Em um sistema, componentes (serviços, clientes) se comunicam através de **APIs** e diversos protocolos — síncronos (REST, gRPC) e assíncronos (mensageria/filas). Entender como componentes se comunicam é fundamental para projetar sistemas compostos por múltiplas partes.

## Comunicação síncrona (requisição/resposta)

```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
```

## Comunicação assíncrona (mensageria)

```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
```

## Escolha e considerações

```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
```

## Por que isso importa

Entender como componentes se comunicam via APIs é fundamental porque **sistemas são compostos por múltiplas partes que devem se comunicar**, então entender a comunicação é essencial para projetá-los.

Sistemas consistem em serviços e clientes que interagem, e como eles se comunicam é um aspecto fundamental do design de sistemas.

Entender **comunicação síncrona** (requisição/resposta onde o chamador aguarda) — **REST** (a abordagem HTTP/JSON onipresente), **gRPC** (RPC de alto desempenho para serviços internos), e GraphQL (consultas flexíveis) — cobre as formas comuns de componentes fazerem chamadas diretas esperando uma resposta.

Entender **comunicação assíncrona** (desacoplada, não-bloqueante) — **filas de mensagens** (enviando mensagens para processamento posterior), **streaming de eventos** (Kafka), e pub/sub — é igualmente importante, pois possibilita **desacoplamento, resiliência (filas amortecendo carga), escalabilidade e sistemas orientados a eventos**, ao custo de maior complexidade e consistência eventual.

Entender a **distinção síncrono vs assíncrono e quando usar cada um** — síncrono quando o chamador precisa de uma resposta imediata, assíncrono quando desacoplamento, resiliência ou processamento em background importa — é uma consideração de design chave que afeta significativamente as características de um sistema.

Entender considerações adicionais (contratos de API claros, versionamento, tratamento de erros, timeouts/retries, autenticação, rate limiting) reflete o design de comunicação robusta.

Como sistemas são compostos de partes que se comunicam e como elas se comunicam (síncrono vs assíncrono, os protocolos, e as considerações de design) fundamentalmente molda o sistema, e como entender comunicação entre componentes é essencial para projetar sistemas multi-componentes, entender como componentes se comunicam via APIs é conhecimento de design de sistemas essencial e fundamental — fundamental para projetar sistemas compostos por múltiplas partes que interagem, cobrindo a comunicação síncrona e assíncrona que conecta componentes, e central para arquitetar os sistemas distribuídos e baseados em serviços comuns hoje.