Retry-After

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

  • In einer 503 Service Unavailable-Antwort zeigt 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 Weiterleitungsantwort, wie z.B. 301 Moved Permanently, zeigt dieser die minimale Wartezeit an, die der Benutzeragent einhalten soll, bevor die umgeleitete Anfrage gesendet wird.
Header-Typ Antwort-Header
Verbotener Header-Name Nein

Syntax

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

Direktiven

<http-date>

Ein Datum, nach dem ein erneuter Versuch erfolgen soll. Weitere Details zum HTTP-Datumsformat finden Sie im Date-Header.

<delay-seconds>

Eine nicht-negative dezimale Ganzzahl, die die Sekunden angibt, die nach Erhalt der Antwort verzögert werden sollen.

Beispiele

Umgang mit geplanter Ausfallzeit

Die Unterstützung für den Retry-After-Header bei sowohl Clients als auch Servern ist noch inkonsistent. Einige Crawler und Spider, wie der Googlebot, beachten jedoch den Retry-After-Header. Es ist nützlich, ihn 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

BCD tables only load in the browser

Siehe auch