Anleitungen

Die Nutzung Ihres Schlüssels überwachen, bevor Sie an ein Limit stoßen

Zu erfahren, dass Sie kurz vor Ihrem Tageslimit stehen, weil gerade eine Anfrage abgelehnt wurde, ist der am wenigsten hilfreiche Weg, es herauszufinden. Jede Antwort enthält bereits die Zahlen, die Sie brauchen, um es kommen zu sehen.

Die Header, auf die Sie achten sollten

X-Quota-Limit: 2500
X-Quota-Used: 2210
X-Quota-Free-Remaining: 290
X-Quota-Network-Used: 2210
X-Credits-Remaining: 5.75
X-Key-IPs-Used: 2
X-Key-IPs-Limit: 3
X-Quota-Reset: 2026-09-22T00:00:00Z

Wenn X-Quota-Free-Remaining gegen null schrumpft, ist das Ihr deutlichstes Frühwarnsignal für das kostenlose Tageskontingent. X-Credits-Remaining zeigt Ihnen, wie viel Spielraum noch bleibt, sobald Sie das kostenlose Kontingent überschritten haben und auf Prepaid-Guthaben zu 0,0001 € pro Anfrage zurückgreifen.

Eine eigene Warnschwelle festlegen

Statt auf einen 429 zu warten, protokollieren Sie oder lösen eine Warnung aus, sobald X-Quota-Free-Remaining unter eine selbst gewählte Schwelle fällt, etwa 10 Prozent von X-Quota-Limit. So bleibt Zeit zu reagieren, sei es, indem Sie einen Batch-Job verlangsamen, Guthaben aufladen oder sich einfach auf eine ruhige Phase bis X-Quota-Reset einstellen.

Auch die IP-Plätze des Schlüssels im Blick behalten

X-Key-IPs-Used und X-Key-IPs-Limit erfassen, wie viele verschiedene Quelladressen einen Schlüssel im Rahmen seines rollierenden IP-Platz-Kontingents verwendet haben. Wird ein Schlüssel plötzlich von mehr Adressen als erwartet genutzt und nähert sich seinem Limit, lohnt sich eine eigene Untersuchung, unabhängig vom Anfragevolumen, denn das kann darauf hindeuten, dass ein Schlüssel weiter verbreitet wird als beabsichtigt.

Ein einfaches Dashboard bauen

Ein kleines Skript, das diese Header bei einer Stichprobe von Anfragen protokolliert, oder bei jeder Anfrage, wenn das Volumen gering genug ist, liefert Ihnen einen Nutzungstrend über die Zeit, ohne dass ein separater Überwachungsaufruf nötig ist, denn die Zahlen kommen mit Antworten, die Sie ohnehin erhalten. Wenn Sie X-Quota-Used über einen Tag oder eine Woche gegen die Zeit auftragen, werden Nutzungsmuster sichtbar, die eine einzelne Momentaufnahme nie zeigen würde.

Handeln, bevor Sie an die Grenze stoßen

Sobald Sie ein beständiges Muster erkennen, dass Sie nah an Ihrem Limit laufen, gibt es dieselben zwei Wege wie zu jedem anderen Zeitpunkt: Prepaid-Guthaben für gelegentliche Spitzen hinzufügen oder zu einem Unlimited-Schlüssel für 50 € pro Monat wechseln, wenn Sie das kostenlose Kontingent regelmäßig überschreiten. Beide Entscheidungen lassen sich in Ruhe und im Voraus leichter treffen als als Reaktion auf einen akuten 429, der echten Traffic blockiert.

Wenn Sie Kontingent-Header als routinemäßige Telemetrie lesen und nicht nur prüfen, wenn eine Anfrage fehlschlägt, wird aus einem harten Limit ein beherrschbarer Trend. Das aktuelle Kontingent und die Guthabenoptionen finden Sie auf der Preisseite, die vollständigen Header-Definitionen in der Dokumentation zu Ratenlimits.