Zum Hauptinhalt springen

4. 429 Zu viele Anfragen (Too Many Requests)

Der 429-Statuscode zeigt an, dass der Benutzer in einem bestimmten Zeitraum zu viele Anfragen gesendet hat ("Ratenbegrenzung").

Die Antwortdarstellungen sollten (SHOULD) Details enthalten, die die Bedingung erklären, und können (MAY) einen Retry-After-Header enthalten, der angibt, wie lange gewartet werden muss, bevor eine neue Anfrage gestellt wird.

Zum Beispiel:

HTTP/1.1 429 Too Many Requests
Content-Type: text/html
Retry-After: 3600

<html>
<head>
<title>Too Many Requests</title>
</head>
<body>
<h1>Too Many Requests</h1>
<p>I only allow 50 requests per hour to this Web site per
logged in user. Try again soon.</p>
</body>
</html>

Beachten Sie, dass diese Spezifikation nicht definiert, wie der Ursprungsserver den Benutzer identifiziert oder wie er Anfragen zählt. Beispielsweise kann ein Ursprungsserver, der Anforderungsraten begrenzt, dies auf der Grundlage von Anfragezählungen pro Ressource, über den gesamten Server oder sogar über eine Gruppe von Servern tun. Ebenso kann er den Benutzer anhand seiner Authentifizierungsdaten oder eines zustandsbehafteten Cookies identifizieren.

Antworten mit dem 429-Statuscode dürfen nicht (MUST NOT) von einem Cache gespeichert werden.