Die Nutzung Ihres Schlüssels überwachen, bevor Sie an ein Limit stoßen
Wenn Sie Ihre Kontingent-Header laufend beobachten, wissen Sie, wann ein Limit näher rückt, lange bevor eine Anfrage tatsächlich abgelehnt wird.
Eine 429-Antwort verarbeiten, ohne die Anfrage zu verlieren
Ein Statuscode 429 ist nicht dieselbe Art von Fehler wie ein 400 oder ein 404. Er bedeutet, dass die Anfrage korrekt aufgebaut war und funktioniert hätte, aber Ihr Kontingent für den aktuellen Zeitraum aufgebraucht ist.
So sieht die Antwort aus
HTTP/1.1 429 Too Many Requests
X-Quota-Limit: 2500
X-Quota-Used: 2500
X-Quota-Free-Remaining: 0
X-Credits-Remaining: 0.00
X-Quota-Reset: 2026-09-22T00:00:00Z
{
"status": "error",
"error": {"code": "quota_exceeded", "message": "Daily quota exceeded"}
}Verwerfen Sie die Anfrage nicht
Der häufigste Fehler ist, ein 429 genauso zu behandeln wie ein 400, es als Fehlschlag zu protokollieren und weiterzumachen. Die zugrunde liegende Abfrage, die der Nutzer oder Ihr Skript wollte, ist weiterhin völlig gültig, sie muss nur später oder mit anderen Zugangsdaten ausgeführt werden. Legen Sie die ursprünglichen Anfragedaten in eine Warteschlange für einen erneuten Versuch, statt sie zu verwerfen.
Den Zeitpunkt des Zurücksetzens auslesen
Der Header X-Quota-Reset in der 429-Antwort sagt Ihnen genau, wann das Tageskontingent zurückgesetzt wird. Ein Hintergrundjob kann bis zu diesem Zeitpunkt pausieren und dann die Warteschlange fortsetzen, statt wiederholt abzufragen oder ein festes Wiederholungsintervall zu raten.
Ein zweites Szenario, auf das Sie sich einstellen sollten
Ein 429 bedeutet nicht immer, dass das gesamte Tageskontingent verbraucht ist. Wenn X-Key-IPs-Used den Wert von X-Key-IPs-Limit erreicht hat, kann ein Schlüssel vorübergehend von einer neuen Quelladresse abgewiesen werden, während Anfragen von seinen üblichen Adressen weiterhin erfolgreich wären. Zu prüfen, welcher Header das 429 tatsächlich erklärt, ein erschöpftes Kontingent oder das Limit der IP-Plätze, ändert die Lösung: im einen Fall auf das Zurücksetzen warten, im anderen die Anzahl verschiedener Rechner verringern, die denselben Schlüssel verwenden.
Zwei Wege, das Limit sofort zu überwinden
Wenn Warten keine Option ist, gibt es zwei sofortige Möglichkeiten: Prepaid-Guthaben zu 0,0001 € pro Anfrage aufladen oder zu einem Unlimited-Schlüssel für 50 € pro Monat wechseln, wenn es sich um ein wiederkehrendes Muster statt einer einmaligen Spitze handelt. Beides entfernt die tägliche Obergrenze, die das 429 überhaupt erst ausgelöst hat.
Schlüssellimits von Netzwerklimits unterscheiden
Da das kostenlose Kontingent für ein ganzes /24 bei IPv4 oder /48 bei IPv6 gemeinsam gilt, kann ein 429 durch Traffic anderer Adressen im selben Netz entstehen und nicht nur durch die Nutzung Ihres eigenen Schlüssels. Prüfen Sie X-Quota-Network-Used zusammen mit X-Quota-Used, um die beiden Situationen zu unterscheiden, bevor Sie entscheiden, ob ein Schlüssel-Upgrade tatsächlich etwas behebt.
Ein Fehler, den Sie vermeiden sollten
Eine fehlgeschlagene Anfrage sofort in einer engen Schleife zu wiederholen, sobald ein 429 zurückkommt, erzeugt nur weitere fehlgeschlagene Aufrufe auf einem bereits erschöpften Kontingent, ohne Sie einer funktionierenden Anfrage näherzubringen. Warten Sie bis zum Zeitpunkt des Zurücksetzens aus dem Header oder, wenn der Codepfad keine Header liest, eine sinnvolle feste Verzögerung ab, statt den Endpunkt sofort erneut zu bombardieren.
Ein 429 als „gleich noch einmal versuchen“ statt als „fehlgeschlagen“ zu behandeln, hält eine Warteschlange über das Zurücksetzen des Kontingents hinweg reibungslos in Bewegung, statt Arbeit zu verlieren. Details zu den Fehlerstrukturen der gesamten API finden Sie auf der Seite zu Fehlern, die aktuellen Kontingentoptionen auf der Preisseite.