Migration

Migration von ip-api.com

ip-api.com hat sich mit einem wirklich einfachen Antwortformat eine Anhängerschaft aufgebaut: ein flaches JSON-Objekt pro Abfrage mit Feldern wie country, regionName, city, lat, lon, isp und query, das die abgefragte IP-Adresse enthält, praktisch ohne Verschachtelung. Diese Flachheit machte es zu einer häufigen ersten Wahl für alle, die einem Projekt grundlegende IP-Geolokalisierung hinzufügen wollten, ohne ein aufwendigeres Schema lernen zu müssen.

Die IP-Geolokalisierung gehört zu den Abfragen, bei denen sich Ergebnisse tatsächlich durchgängig funktionierend zeigen lassen, anders als bei Geokodierung oder Autovervollständigung, bei denen nur die Form beschrieben wird. Eine Anfrage für eine IPv4- oder IPv6-Adresse liefert Land, Region, Stadt, Koordinaten und Netzwerkinformationen aus Daten, die über unsere eigene Caching-Pipeline aktuell gehalten werden, statt aus einem statischen oder nur langsam aktualisierten Datensatz.

Der Kompatibilitätshost von My Geocode für ip-api bildet die flache Feldstruktur exakt nach, einschließlich country, regionName, city, lat, lon, isp und query, wobei die Texte zu Urheberrecht, Nutzungsbedingungen und Datenschutz der einzige inhaltliche Unterschied sind. Referenzdetails finden Sie unter /compatibility/ip-api/. Code, der response.city oder response.isp direkt liest, ohne ein verschachteltes Objekt zu entpacken, sollte weiter funktionieren, sobald Host und Schlüssel geändert sind.

Was sich bei dieser Migration konkret ändert:

  • Die Authentifizierung wechselt zu einem Schlüssel, gesendet als X-API-Key-Header, Authorization: Bearer, HTTP Basic Auth oder Query-Parameter, statt einer nicht authentifizierten oder nur leicht begrenzten öffentlichen Abfrage
  • Das Kontingent ist jetzt in jeder Antwort direkt über Header wie X-Quota-Limit, X-Quota-Used und X-Quota-Reset sichtbar, statt aus gelegentlicher Drosselung erschlossen werden zu müssen
  • Optionale Zusatzfelder (IP-Bedrohungsdetails und tiefere Netzwerkinformationen) sind verfügbar, wenn Sie mg_extras=1 oder einen X-MG-Extras-Header hinzufügen, ohne die flache Form zu verändern, die Ihr Code bereits parst

Es gibt 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel, und jeder Schlüssel erhält zusätzlich 2.500 kostenlose Anfragen pro Tag, gezählt pro Netzwerk, ob IPv4 (pro /24) oder IPv6 (pro /48), geteilt zwischen der Nutzung mit und ohne Schlüssel aus diesem Netzwerk. Über dieses Kontingent hinaus gibt es Prepaid-Guthaben zu 0,0001 € pro Anfrage oder einen Unlimited-Schlüssel für 50 € pro Monat, und jeder Endpunkt, einschließlich dieses Kompatibilitätshosts, kostet gleich viel.

Für Anwendungen mit IP-basierten Länderweiterleitungen, Prüfungen auf Betrugssignale oder einfacher Anreicherung von Analysedaten ist das meist eine der einfacheren Migrationen, die sich durchgängig testen lassen, da die Ergebnisse konkret sind und sich direkt mit dem vergleichen lassen, was die aktuelle Integration für dieselben Testadressen zurückgibt.