Upstream Service Error 502
Un servicio del que dependemos respondió con un error inesperado.
Política de retry: Reintentar con backoff exponencial
type: /api/v1/problems/backend-rpc-error
Cuándo se dispara
- El servicio dependiente devolvió un error temporal.
- Un componente interno reportó un fallo no fatal.
- Incidente transitorio que el reintento puede resolver.
Para clientes OAuth2
Reintentá con backoff exponencial (1s, 2s, 4s, máximo 3 intentos). Si el error persiste, contactá a soporte con el instance del response — ayuda a ubicar el incidente exacto.
Para Fracttal One
Reintentar 1-2 veces silenciosamente con backoff. Si persiste, mostrar mensaje genérico de error con opción de reintentar. Loguear instance para soporte.
Body de ejemplo
{
"type": "/api/v1/problems/backend-rpc-error",
"title": "Upstream Service Error",
"status": 502,
"detail": "Upstream service returned an error",
"instance": "/api/v1/dags"
}
Endpoints donde puede aparecer
- Cualquier endpoint que dependa de servicios externos
Códigos internos asociados
UPSTREAM_ERROR
Problems relacionados
- Service Temporarily Unavailable (
503) - Request Timed Out (
504)