Lee el envelope estable
Cada error incluye code y message. Las solicitudes detrás del gateway también incluyen requestId para correlación.
{
"code": "idempotency_conflict",
"message": "Idempotency-Key was used with a different request",
"requestId": "request_reference"
}
Clasifica antes de reintentar
Reintenta fallos de red, 429 y algunos 5xx con backoff exponencial y jitter. Corrige payload, scope o propiedad en errores 4xx.
- 401: sustituye o rota la credencial inválida
- 403: emite una key con el scope requerido
- 409: revisa el código de idempotencia o límite de plan
- 429: espera el valor de Retry-After
Conserva una key por operación
Genera la clave de idempotencia al iniciar la operación de negocio, persístela y reutilízala en cada reintento de transporte durante 24 horas.