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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Retry-After

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Siehe auch