Express.js
Explica cómo consumir servicios externos desde Express.js con timeouts, retries, circuit breakers, validación, presupuestos de latencia y degradación controlada.
Una llamada externa puede fallar, tardar o responder de forma ambigua. La resiliencia consiste en limitar el daño y conservar una interpretación correcta del resultado.
Express suele depender de pagos, correo, inventario remoto o APIs internas. La red introduce fallos parciales:
request local
↓
servicio externo
↓
response, timeout o resultado ambiguoToda llamada necesita límite:
const response = await fetch(url, {
signal: AbortSignal.timeout(2_000),
});Un timeout deja de esperar; no garantiza que el proveedor detenga el trabajo. La operación remota puede haber ocurrido.
El timeout externo debe caber dentro del deadline total:
proxy 10s
→ app 8s
→ dependency 2s
→ margen para mapear y responderNo permitas que cada dependencia consuma el timeout completo de la request.
Reintenta únicamente cuando:
Usa exponential backoff y jitter. Los retries inmediatos sincronizados pueden empeorar una caída.
Un timeout de pago no significa pago rechazado. Registra estado unknown o pending, consulta al proveedor y reconcilia usando una referencia idempotente.
Un breaker evita insistir contra una dependencia claramente caída:
closed → llamadas normales
open → fallo rápido
half-open → pruebas limitadasNo sustituye timeouts. Debe medirse y configurarse por dependencia/operación.
Limita concurrencia por integración para que un proveedor lento no consuma todos los sockets o conexiones. Colas, semáforos y pools separados crean aislamiento.
Un fallback solo es válido si conserva semántica:
La respuesta externa también es no confiable. Verifica status, Content-Type, schema y límites. No asumas que un 200 contiene el JSON esperado.
Traduce fallos internos:
El contrato puede variar, pero no expongas URLs internas, tokens o bodies sensibles.
Registra:
Evita alta cardinalidad con URLs completas o IDs arbitrarios en métricas.
Crear un envío:
create_delivery.orderId.Background jobs y colas mueve trabajo durable fuera del lifecycle HTTP.