¿Cómo se comunican los componentes en un sistema (APIs)?

Question

Accepted Answer

En un sistema, los componentes (servicios, clientes) se comunican a través de **APIs** y varios protocolos — síncronos (REST, gRPC) y asíncronos (mensajería/colas). Entender cómo se comunican los componentes es fundamental para diseñar sistemas compuestos de múltiples partes.

## Comunicación síncrona (petición/respuesta)

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

## Comunicación asíncrona (mensajería)

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

## Elegir y consideraciones

```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 qué es importante

Entender cómo se comunican los componentes a través de APIs es fundamental porque **los sistemas están compuestos de múltiples partes que deben comunicarse**, por lo que entender la comunicación es esencial para diseñarlos.

Los sistemas constan de servicios y clientes que interactúan, y cómo se comunican es un aspecto fundamental del diseño de sistemas.

Entender la **comunicación síncrona** (petición/respuesta donde el llamador espera) — **REST** (el enfoque HTTP/JSON ubicuo), **gRPC** (RPC de alto rendimiento para servicios internos), y GraphQL (consultas flexibles) — cubre las formas comunes en que los componentes hacen llamadas directas esperando una respuesta.

Entender la **comunicación asíncrona** (desacoplada, no bloqueante) — **colas de mensajes** (enviar mensajes para procesamiento posterior), **transmisión de eventos** (Kafka), y pub/sub — es igualmente importante, ya que permite **desacoplamiento, resiliencia (colas amortiguando carga), escalabilidad, y sistemas impulsados por eventos**, al costo de mayor complejidad y consistencia eventual.

Entender la **distinción síncrono vs asíncrono y cuándo usar cada uno** — síncrono cuando el llamador necesita una respuesta inmediata, asíncrono cuando el desacoplamiento, la resiliencia, o el procesamiento en segundo plano importa — es una consideración clave de diseño que afecta significativamente las características de un sistema.

Entender consideraciones adicionales (contratos de API claros, versionado, manejo de errores, timeouts/reintentos, autenticación, limitación de velocidad) refleja el diseño de comunicación robusta.

Ya que los sistemas están compuestos de partes que se comunican y cómo se comunican (síncrono vs asíncrono, los protocolos, y las consideraciones de diseño) modela fundamentalmente el sistema, y ya que entender la comunicación de componentes es esencial para diseñar sistemas multi-componente, entender cómo se comunican los componentes a través de APIs es conocimiento esencial de diseño de sistemas, fundamental para diseñar sistemas compuestos de múltiples partes que interactúan, cubriendo la comunicación síncrona y asíncrona que conecta componentes, y central para arquitecturar los sistemas distribuidos basados en servicios comunes hoy.