Service Temporarily Unavailable 503
El servicio está temporalmente indisponible y rechaza requests para protegerse.
Política de retry: Reintentar con backoff exponencial
type: /api/v1/problems/backend-unavailable
Cuándo se dispara
- Una dependencia interna está respondiendo con fallas repetidas.
- El servicio decidió cortar tráfico durante el incidente para recuperarse más rápido.
- Mantenimiento programado o incidente activo.
Para clientes OAuth2
Reintentá con backoff exponencial empezando en 30 segundos. No uses retries agresivos — solo prolongan la indisponibilidad. Si el error persiste por más de 5 minutos, contactá a soporte con el instance del response y la hora aproximada del incidente.
Para Fracttal One
Mostrar al usuario "el servicio está temporalmente no disponible, intentá nuevamente en unos minutos" con CTA de reintentar manual. Evitar retries automáticos rápidos. Mostrar datos cacheados localmente si están disponibles.
Body de ejemplo
{
"type": "/api/v1/problems/backend-unavailable",
"title": "Service Temporarily Unavailable",
"status": 503,
"detail": "Service temporarily unavailable. Please try again shortly.",
"instance": "/api/v1/dags"
}
Endpoints donde puede aparecer
- Cualquier endpoint
Códigos internos asociados
SERVICE_UNAVAILABLE
Problems relacionados
- Request Timed Out (
504) - Upstream Service Error (
502)