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.
Ihre Integration testen, ohne Ihr Tageskontingent zu verbrauchen
Eine Integration aufzubauen bedeutet meist Dutzende oder Hunderte von Testaufrufen, bevor irgendetwas in die Nähe von Produktions-Traffic kommt, und nichts von diesen Tests muss einen kostenpflichtigen Tarif berühren.
Testen ganz ohne Schlüssel
2.500 kostenlose Anfragen pro Tag stehen von jeder Adresse aus zur Verfügung, ganz ohne Schlüssel. Das reicht für die meiste Integrationsarbeit: Anfrageformatierung einrichten, das Parsen der Antworten prüfen und die Fehlerbehandlung mit jeweils einer Handvoll Testfällen durchspielen.
GET /v1/forward?q=Test Address, Test City&limit=1Kein X-API-Key-Header, kein Authorization-Header, nichts als die Anfrage selbst.
Kontingent-Header beim Testen beobachten
Auch ohne Schlüssel enthält jede Antwort dieselben Kontingent-Header, sodass Sie beobachten können, wie X-Quota-Used und X-Quota-Free-Remaining genau so steigen und sinken wie in der Produktion. Das ist nützlich, um zu testen, wie Ihr eigener Code mit diesen Headern umgeht, bevor es ernst wird.
X-Quota-Limit: 2500
X-Quota-Used: 42
X-Quota-Free-Remaining: 2458Einen Schlüssel testen, ohne Guthaben zu verbrauchen
Sobald Sie sich registrieren und einen Schlüssel erzeugen, erhält dieser Schlüssel zusätzlich eigene 2.500 kostenlose Anfragen pro Tag, einen separaten Testspielraum, der weder Prepaid-Guthaben berührt noch auf ein Unlimited-Paket angerechnet wird. Jetzt ist der richtige Zeitpunkt, schlüsselspezifisches Verhalten zu testen, etwa die verschiedenen Arten, den Schlüssel zu senden (Header, Bearer-Token, Basic Auth oder Query-Parameter), und das alles, ohne etwas auszugeben.
Fehlerpfade gezielt testen
Senden Sie eine Anfrage mit einem ungültigen Parameter, um einen 400 zu sehen, oder mit einem absichtlich falschen Schlüssel, um einen 401 zu sehen. So ist Ihr Code zur Fehlerbehandlung vor dem Start tatsächlich durchlaufen worden, statt dass Sie nur annehmen, er funktioniere. Jeder dieser Testaufrufe, ob erfolgreich oder nicht, zählt als eine Anfrage gegen das kostenlose Kontingent, was Sie bei normalem Testvolumen nicht beunruhigen sollte.
Umstieg auf Produktionsverkehr
Sobald echter Verkehr beginnt, deckt dasselbe kostenlose Kontingent bei vielen kleineren Integrationen weiterhin die typische tägliche Nutzung ab. Prepaid-Guthaben oder ein Unlimited-Paket brauchen Sie erst, wenn das Volumen 2.500 Anfragen pro Tag übersteigt.
Eine separate Sandbox-Umgebung ist hier nicht nötig, denn das kostenlose Kontingent bietet bereits eine vollständige Testumgebung mit der echten API. Erzeugen Sie zum Einstieg einen Schlüssel im Dashboard, oder lesen Sie zuerst die Dokumentation zur Authentifizierung, wenn Sie die Schlüsselformate vor der Registrierung sehen möchten.