Errores y reintentos

​

Objetivo

​

Regla general

• 4xx: el problema suele estar en request, permisos o estado de negocio
• 5xx: el problema suele estar en el backend o dependencia externa

​

Tabla rapida

​

Politica de retry

• 429
• 500
• 502
• 503
• 504
• 401 solo despues de renovar token

• 400
• 403
• 404
• 409
• 422

​

Backoff recomendado

intento 1: inmediato
intento 2: +1s
intento 3: +3s
intento 4: +7s

• 3 a 4 intentos

​

Payload de error

• leer statusCode
• leer message
• leer error si existe

{
  "statusCode": 404,
  "message": "Client not found",
  "error": "Not Found"
}

​

Casos frecuentes

​

401 tras login exitoso

• token vencido
• token mal formateado
• falta prefijo Bearer

​

409 al crear

• cliente ya existe por RUT
• recurso duplicado
• regla de unicidad incumplida

​

404 en rutas encadenadas

• se creo el recurso padre en otro ambiente
• se uso una ruta legacy con ID distinto al esperado
• el recurso fue transferido o eliminado

​

Observabilidad minima

• endpoint
• metodo HTTP
• status code
• correlation id si existe
• mensaje de error
• payload resumido sin secretos

​

Referencias

• Autenticacion
• Convenciones de la API
• Introduccion API