Signification
Le serveur ne peut temporairement pas traiter la requête, à cause d'une surcharge ou d'une maintenance. Retry-After peut indiquer quand réessayer.
Causes courantes
- Maintenance planifiée
- Serveur surchargé ou à court de workers
- Mise à l'échelle automatique en retard, ou panne de dépendances
Comment corriger
Côté client ou visiteur
Réessayez plus tard en respectant Retry-After.
Côté propriétaire du site ou de l’API
Envoyez Retry-After pendant la maintenance, augmentez la capacité et délestez la charge proprement. Les moteurs de recherche traitent les 503 courtes comme temporaires.
Exemple de réponse
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."
}Spécification
FAQ
› 503 convient-il aux pages de maintenance ?
Oui. Renvoyez 503 avec Retry-After ; les moteurs gardent alors la page indexée au lieu de la considérer comme disparue.
› 503 ou 500 ?
503 indique que l'indisponibilité est temporaire et devrait se résorber ; 500 est une panne inattendue.