O que significa
O servidor está temporariamente incapaz de atender a requisição, por sobrecarga ou manutenção. Retry-After pode dizer quando tentar de novo.
Causas comuns
- Manutenção planejada
- Servidor sobrecarregado ou sem workers
- Autoscaling atrasado ou falhas em dependências
Como resolver
Se você é o cliente ou visitante
Tente de novo mais tarde, respeitando o Retry-After.
Se você mantém o site ou a API
Envie Retry-After durante a manutenção, aumente a capacidade e descarte carga de forma elegante. Buscadores tratam 503 curtos como temporários.
Resposta de exemplo
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."
}Especificação
Perguntas frequentes
› 503 é bom para páginas de manutenção?
Sim. Retorne 503 com Retry-After; assim os buscadores mantêm a página indexada em vez de tratá-la como removida.
› 503 ou 500?
503 diz que a indisponibilidade é temporária e deve se recuperar; 500 é uma falha inesperada.