Qué significa
El servidor no puede atender la petición temporalmente por sobrecarga o mantenimiento. Retry-After puede indicar cuándo volver a intentarlo.
Causas habituales
- Mantenimiento programado
- Servidor sobrecargado o sin workers
- El autoescalado no da abasto, o caídas de dependencias
Cómo solucionarlo
Si eres el cliente o visitante
Reintenta más tarde respetando Retry-After.
Si administras el sitio o la API
Envía Retry-After durante el mantenimiento, amplía la capacidad y descarta carga con elegancia. Los buscadores tratan los 503 breves como temporales.
Respuesta de ejemplo
HTTP/1.1
HTTP/1.1 503 Service Unavailable
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 120
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Service Unavailable",
"status": 503,
"detail": "Down for maintenance until 02:00 UTC."
}Especificación
Preguntas frecuentes
› ¿503 es bueno para páginas de mantenimiento?
Sí. Devuelve 503 con Retry-After; así los buscadores mantienen la página indexada en lugar de darla por desaparecida.
› ¿503 o 500?
503 indica que la caída es temporal y se espera que se recupere; 500 es un fallo inesperado.