Retry-After

Der HTTP-Retry-After-Antwort-Header gibt an, wie lange der Benutzeragent warten sollte, bevor eine nachfolgende Anfrage gestellt wird. Es gibt drei Hauptfälle, in denen dieser Header verwendet wird:

  • In einer 503 Service Unavailable-Antwort gibt er an, wie lange der Dienst voraussichtlich nicht verfügbar sein wird.
  • In einer 429 Too Many Requests-Antwort gibt er an, wie lange gewartet werden sollte, bevor eine neue Anfrage gestellt wird.
  • In einer Umleitungsantwort, wie z.B. 301 Moved Permanently, gibt er die Mindestzeit an, die der Benutzeragent warten soll, bevor die umgeleitete Anfrage ausgeführt wird.
Header-Typ Antwort-Header
Verbotener Anfrage-Header Nein

Syntax

http
Retry-After: <http-date>
Retry-After: <delay-seconds>

Anweisungen

<http-date>

Ein Datum, nach dem die Wiederholung stattfinden soll. Siehe den Date-Header für mehr Details zum HTTP-Datumsformat.

<delay-seconds>

Eine nichtnegative Dezimalzahl, die die Sekunden angibt, um die nach dem Erhalt der Antwort verzögert werden soll.

Beispiele

Umgang mit geplanter Ausfallzeit

Die Unterstützung des Retry-After-Headers sowohl auf Clients als auch auf Servern ist nach wie vor inkonsistent. Einige Crawler und Spider, wie der Googlebot, beachten jedoch den Retry-After-Header. Es ist nützlich, ihn zusammen mit einer 503-Antwort zu senden, damit Suchmaschinen Ihre Website weiterhin indexieren, wenn die Ausfallzeit vorbei ist.

http
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT
Retry-After: 120

Spezifikationen

Specification
HTTP Semantics
# field.retry-after

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch