Retry-After

Verwendung

Der Retry-After-Header erscheint in Antworten, bei denen der Server den Client zu einer Wartezeit vor einem erneuten Versuch veranlassen muss. Der Header wird üblicherweise mit drei Statuscodes kombiniert:

Der Header akzeptiert zwei Formate: eine Verzögerung in Sekunden (delta-seconds) oder ein absolutes HTTP-date. Bei Sekunden ist der Wert eine nicht negative Ganzzahl, die die Anzahl der zu wartenden Sekunden angibt. Bei einem HTTP-date folgt der Wert dem Format IMF-fixdate.

Wohlerzogene Clients und Crawler befolgen diesen Header, um einen sich erholenden Server nicht zu überlasten.

Hinweis

Suchmaschinen-Crawler werten Retry-After in 503-Antworten als Signal, die URL später erneut zu besuchen, statt die Seite aus dem Index zu entfernen. Sowohl Googlebot als auch Bingbot respektieren diesen Header für die Planung erneuter Besuche. Während geplanter Wartungsarbeiten bewahrt eine Antwort mit 503 Service Unavailable und Retry-After die Indexierbarkeit. Ohne den Header riskiert eine längere Ausfallzeit die Deindexierung.

Delta-seconds

Eine nicht negative Ganzzahl, die angibt, wie viele Sekunden der Client warten muss, bevor er die Anfrage wiederholt.

Retry-After: 120

HTTP-date

Ein absolutes Datum mit Uhrzeit im Format IMF-fixdate, nach dem es dem Client freisteht, die Anfrage zu wiederholen. Das Datum verwendet GMT und folgt dem Format Day, DD Mon YYYY HH:MM:SS GMT.

Retry-After: Sat, 31 Oct 2026 18:00:00 GMT

Beispiel

Ein Server, der während eines Wartungsfensters mit 503 antwortet, weist den Client an, 3600 Sekunden (eine Stunde) bis zum erneuten Versuch zu warten.

HTTP/1.1 503 Service Unavailable
Retry-After: 3600

Ein API-Ratenbegrenzer, der mit 429 antwortet, gibt ein absolutes Datum an, zu dem das Ratenlimit zurückgesetzt wird. Der Client pausiert seine Anfragen bis zum angegebenen Zeitpunkt.

HTTP/1.1 429 Too Many Requests
Retry-After: Sat, 31 Oct 2026 12:30:00 GMT

Eine geplante Weiterleitung mit 301 enthält eine Verzögerung, um sofortige Wiederholungswellen von mehreren Clients zu verhindern.

HTTP/1.1 301 Moved Permanently
Location: https://new.example.re/resource
Retry-After: 60

Hinweis

API-Ratenbegrenzer kombinieren Retry-After häufig mit RateLimit-Limit-Headern. Der Header RateLimit-Remaining zeigt, wie viele Anfragen im aktuellen Zeitfenster noch übrig sind, während Retry-After den Clients genau mitteilt, wann sie nach einer 429-Antwort fortfahren können. Gut entworfene APIs senden beides, damit Clients ihre Anfragerate behutsam drosseln, statt einen ratenbegrenzten Endpunkt weiter zu bombardieren.