Retry-After header

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

  • In einer 503 Service Unavailable Antwort gibt dieser an, wie lange der Dienst voraussichtlich nicht verfügbar sein wird.
  • In einer 429 Too Many Requests Antwort gibt dieser an, wie lange gewartet werden soll, bevor eine neue Anfrage gestellt wird.
  • In einer Redirect-Antwort, wie etwa 301 Moved Permanently, gibt dieser die minimale Zeit an, die der Benutzeragent warten soll, bevor die umgeleitete Anfrage gestellt wird.
Header-Typ Antwortheader
Verbotener Anfrageheader Nein

Syntax

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

Direktiven

<http-date>

Ein Datum, nach dem Sie es erneut versuchen sollten. Siehe den Date-Header für weitere Details zum HTTP-Datumsformat.

<delay-seconds>

Eine nicht-negative Dezimalzahl, die die Sekunden angibt, die nach Erhalt der Antwort gewartet werden sollen.

Beispiele

Umgang mit geplanter Ausfallzeit

Der Support für den Retry-After-Header bei Clients und Servern ist nach wie vor inkonsistent. Einige Crawler und Spider, wie der Googlebot, beachten jedoch den Retry-After-Header. Es ist nützlich, diesen zusammen mit einer 503-Antwort zu senden, damit Suchmaschinen Ihre Seite 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

Siehe auch