Ratenlimits gelten als verwirrend, voller Ausnahmen und Kleingedrucktem, das erst klar wird, nachdem etwas kaputtgegangen ist. Unsere sind einfacher, und es lohnt sich, sie an einer Stelle verständlich darzulegen.
Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel. Dieses Kontingent gilt nicht für jede Adresse einzeln, sondern wird über ein Netzwerk geteilt: Alle IPv4-Adressen im selben /24 und alle IPv6-Adressen im selben /48 schöpfen gemeinsam aus einem Pool. Das ist wichtig, wenn Sie hinter einem gemeinsam genutzten Büroanschluss oder einer großen NAT-Umgebung (Network Address Translation) sitzen, denn Ihr kostenloses Kontingent wird mit allen anderen im selben Netzwerksegment geteilt, unabhängig davon, ob sie einen Schlüssel verwenden oder nicht.
Jeder Schlüssel erhält außerdem sein eigenes kostenloses Tageskontingent von 2.500 Anfragen, getrennt von dem, was das Netzwerk bereits bereitstellt. Das Kontingent eines Schlüssels wird nicht durch anderen Traffic im selben Netzwerk geschmälert, und das Kontingent eines Netzwerks wird nicht durch Traffic geschmälert, der bereits das separate Kontingent eines Schlüssels aufgebraucht hat. Die beiden Kontingente stehen nebeneinander, statt miteinander zu konkurrieren.
Sind an einem bestimmten Tag beide Kontingente ausgeschöpft, wird eine Anfrage entweder vom Prepaid-Guthaben zu 0,0001 € pro Anfrage abgebucht oder durch ein Unlimited-Paket für 50 € pro Monat abgedeckt, je nachdem, was für das Konto eingerichtet ist. Es gibt keine Drosselung, die Anfragen stillschweigend verlangsamt, und keine überraschende Sperre ohne Erklärung. Jede Antwort enthält Kontingent-Header, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit und X-Quota-Reset, sodass genau sichtbar ist, wo eine Anfrage steht, bevor sie überhaupt fehlschlägt.
Ein Bulk- oder Batch-Aufruf folgt denselben Regeln auf Ebene der einzelnen Elemente, nicht auf Ebene des Aufrufs. Hundert Adressen, die in einem Aufruf gesendet werden, zählen als hundert Anfragen gegen das jeweils geltende Kontingent, genau so, als wären sie in hundert separaten Aufrufen gesendet worden.
All das gilt identisch für jeden Endpunkt und jeden der siebzehn Kompatibilitäts-Hosts. Eine Anfrage im Format von OpenCage oder ipstack unterliegt exakt denselben Ratenlimit-Regeln wie eine direkte Anfrage an /v1/forward oder /v1/ip, ohne ein separates, strengeres Limit, das sich hinter einer vertraut aussehenden Antwortstruktur versteckt.
Alle Details, einschließlich der Funktionsweise des täglichen Zurücksetzens und der Bedeutung jedes Headers, sind unter /docs/rate-limits/ dokumentiert. Sollte in Ihrer Integration jemals eine Frage zu Ratenlimits aufkommen, ist die Antwort fast immer direkt in den Headern der Antwort sichtbar, die sie ausgelöst hat.