Wiederholen

Der Parameter „Retry-After“ gibt an, wann ein erneuter Versuch erfolgreich sein kann. Er tritt bei den Fehlercodes 429 Too Many Requests, 503 Service Unavailable und einigen Weiterleitungen auf und enthält entweder eine Anzahl von Sekunden (Retry-After: 30) oder ein HTTP-Datum. Die Einhaltung dieses Parameters entscheidet darüber, ob ein Client die Verbindung wiederherstellt oder die Wartezeit unnötig verlängert.

So funktioniert es

Der Client analysiert den Wert – beide Formen sind gültig und kommen vor – und plant den Wiederholungsversuch frühestens zu diesem Zeitpunkt. Fehlt der Header, greift der Client auf seine eigene Backoff-Strategie zurück. Korrekt konfigurierte Clients begrenzen zudem die Wartezeit, sodass ein falsch konfigurierter Server sie nicht einen ganzen Tag lang blockieren kann.

Das Missverständnis

Eine Wiederholungsschleife mit einer festen Wartezeit von einer Sekunde wird als "handling 429" bezeichnet. Jeder Client, der dies tut, kontaktiert den Server sofort nach dem Öffnen des Fensters erneut. Die Option „Retry-After“ liefert, sofern vorhanden, bereits die korrekte Anzahl an Wiederholungsversuchen; andernfalls sollte ein Backoff-Mechanismus mit Jitter verwendet werden.

Probieren Sie es hier aus

GET /coffee/v1/rush-hour erlaubt drei Anfragen pro zehn Sekunden und beantwortet die vierte mit 429 und Retry-After; GET /protocol/v1/maintenance beantwortet jede Anfrage mit 503 und Retry-After: 30.

Verwandte Inhalte

• Testing rate limiting and Retry-After
• HTTP 429 Too Many Requests

Quellen

• HTTP semantics — RFC 9110
• HTTP caching — RFC 9111

Weitere Begriffe

• ETag — Eine undurchsichtige Versionskennung für eine Repräsentation, die dazu dient, ein erneutes Senden zu vermeiden und widersprüchliche Schreibvorgänge zu erkennen.
• Sichere und idempotente Methoden — Zwei unabhängige Eigenschaften von HTTP-Methoden, die festlegen, welche Methoden ein Client wiederholen darf.
• PUT vs PATCH — PUT ersetzt eine Ressource durch die von Ihnen gesendete Repräsentation; PATCH wendet eine Reihe von Änderungen darauf an.
• Exponentielles Backoff — Eine Wiederholungsstrategie, bei der jede Wartezeit länger ist als die vorherige, wobei Zufallselemente hinzugefügt werden, damit die Clients nicht synchron wiederholen.
• Zeitüberschreitung der Anfrage — Die maximale Wartezeit eines Clients auf eine Antwort, bevor er die Anfrage abbricht.

Diese Seite auf Englisch lesen

Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert 16. Oktober 2026