HTTP 429 Too Many Requests

Ihre Rate wird begrenzt. Die Antwort sollte Retry-After und üblicherweise X-RateLimit-Limit, -Remaining und -Reset enthalten.

Definiert in RFC 6585 §4 — 429 Too Many Requests · MDN-Referenz

Wo Ihnen HTTP 429 in der Praxis begegnet

Jede API mit einem Kontingent – und dieses wird in der Regel auf einmal erreicht, wenn ein Deployment, eine Retry-Sturmwelle oder ein Batch-Job einen normalerweise ruhigen Client an die Grenze bringt.

Warum Sie ihn testen sollten

Testen Sie, ob Ihr Client bei „Retry-After“ eine Verzögerung auslöst, anstatt sofort einen erneuten Versuch zu starten – ein aggressiver Wiederholungsversuch bei einem 429-Fehler führt dazu, dass aus einer Verlangsamung ein Ausfall wird.

Was Ihr Client bei einem 429 tun sollte

Beachten Sie die Option „Retry-After“. Falls diese fehlt, reduzieren Sie die Geschwindigkeit exponentiell mit Jitter – synchronisierte Wiederholungsversuche vieler Clients erzeugen genau den Lastanstieg, den das Limit eigentlich verhindern soll. Begrenzen Sie die Anzahl der Versuche und vermeiden Sie wiederholte Versuche mit dem Statuscode 429 in einer Endlosschleife. Die Header „X-RateLimit-Remaining“ und „-Reset“ ermöglichen es Ihnen, die Geschwindigkeit zu reduzieren, bevor Sie dazu aufgefordert werden.

429 und die Codes, mit denen er verwechselt wird

Endpunkte, die 429 zurückgeben

5 Endpunkte dieses Playgrounds antworten mit 429. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.

Fragen zu HTTP 429

Was beinhaltet Retry-After?
Entweder eine Anzahl Sekunden oder ein HTTP-Datum. Beide Formen sind gültig, und ein Client muss beide verarbeiten können.
Wird eine fehlgeschlagene Anfrage auf das Limit angerechnet?
Meistens ja. Rate Limits werden in der Regel über eingegangene Anfragen gezählt, nicht über erfolgreiche.

Weitere Client-Fehlercodes

Alle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung

Zuletzt aktualisiert