Viele Anwendungen nutzen IP-Geolokalisierung genau einmal, in dem Moment, in dem sich ein Nutzer zum ersten Mal verbindet, um ein Land zu schätzen oder eine Standardwährung festzulegen und dann weiterzumachen. ipstack ist seit Langem eine gängige Wahl für diesen einen Schritt. Mit unserem neuen Kompatibilitäts-Host funktioniert dieser Schritt weiterhin genauso, nur mit einem anderen Backend.
Der Host bildet die Anfrageparameter und den Antwortinhalt von ipstack präzise nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die sich auf My Geocode statt auf den ursprünglichen Anbieter beziehen. Wo immer Ihre Anwendung derzeit eine Abfrage im ipstack-Format sendet, kann sie dieselbe Abfrage an unseren Host senden, und die zurückkommenden Felder landen an denselben Stellen, die Ihr bestehender Parsing-Code erwartet.
Beide Adressfamilien werden hier vollständig unterstützt, genau wie bei /v1/ip überall sonst auf der Plattform. Eine IPv4-Adresse und eine IPv6-Adresse werden von diesem Host beide korrekt aufgelöst, in beiden Fällen mit derselben Antwortstruktur.
Schlüssel können als X-API-Key-Header, als Authorization: Bearer-Header, per HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder als Query-Parameter übermittelt werden, passend zu dem Muster, das Ihre bestehende ipstack-Integration bereits verwendet. Alle vier werden auf jedem Host und Endpunkt, den wir betreiben, gleich akzeptiert, sodass sich der Authentifizierungscode selten ändern muss.
Die Preise hinter diesem Host sind dieselben wie überall sonst. Jede Adresse erhält 2.500 kostenlose Abfragen pro Tag ohne Schlüssel, gezählt pro Netz, sodass ein gemeinsam genutztes Büro oder Gebäude aus einem Topf schöpft statt aus vielen. Ein Schlüssel fügt für sich weitere 2.500 kostenlose Anfragen pro Tag hinzu. Jenseits dieser Kontingente kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt es für 50 € im Monat ab, ohne gesonderten Preis für diesen Kompatibilitäts-Host.
Jede Antwort enthält außerdem unseren vollständigen Satz an Kontingent-Headern, etwas, das eine einfache ipstack-Integration sonst nicht offenlegen würde: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used und X-Credits-Remaining sind bei jedem einzelnen Aufruf vorhanden.
Wenn Ihr Projekt mehr als die Standardantwort möchte, fügt mg_extras=1 in der Anfrage oder ein X-MG-Extras-Header optionale Felder wie IP-Bedrohungs- und Netzwerkdetails zur kompatiblen Struktur hinzu. Standardmäßig ist es deaktiviert, sodass sich am Antwortformat nichts ändert, solange Sie es nicht ausdrücklich anfordern.
Der Kompatibilitäts-Host ist unter /compatibility/ipstack/ dokumentiert, und die vollständige Referenz zur IP-Abfrage unter /docs/ipv4-lookup/ und /docs/ipv6-lookup/ deckt alles ab, was darunter liegt.