Wat het betekent
De server kan het verzoek tijdelijk niet afhandelen door overbelasting of onderhoud. Retry-After kan zeggen wanneer je het opnieuw kunt proberen.
Veelvoorkomende oorzaken
- Gepland onderhoud
- Server overbelast of zonder vrije workers
- Autoscaling loopt achter of afhankelijkheden liggen plat
Zo los je het op
Als client of bezoeker
Probeer het later opnieuw en respecteer Retry-After.
Als beheerder van de site of API
Stuur Retry-After tijdens onderhoud, schaal capaciteit op en werp belasting netjes af. Zoekmachines zien korte 503's als tijdelijk.
Voorbeeldantwoord
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."
}Specificatie
Veelgestelde vragen
› Is 503 geschikt voor onderhoudspagina's?
Ja. Geef 503 met Retry-After terug; zoekmachines houden de pagina dan geïndexeerd in plaats van haar als verdwenen te zien.
› 503 of 500?
503 zegt dat de storing tijdelijk is en naar verwachting herstelt; 500 is een onverwachte fout.