ip-api.com ist oft der erste Dienst für IP-Geolokalisierung, zu dem Entwickler greifen, vor allem weil er schnell auszuprobieren und leicht in ein Skript einzubinden ist. Genau diese Einfachheit soll unser Kompatibilitäts-Host bewahren, allerdings mit anderen Regeln für Kontingent und Preise dahinter.
Der Host bildet die Anfrageverarbeitung und den Antwortinhalt von ip-api.com exakt nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von uns stammen. Eine Anfrage, die bisher an den Endpunkt von ip-api.com ging, kann stattdessen an unseren gehen, und das zurückkommende JSON lässt sich genauso auswerten, mit denselben Feldnamen an denselben Stellen.
Da /v1/ip beide Adressfamilien vollständig auflöst, behandelt dieser Kompatibilitäts-Host IPv4- und IPv6-Abfragen auf dieselbe Weise. Eine Abfrage für eine IPv4-Adresse und eine Abfrage für eine IPv6-Adresse kommen beide korrekt strukturiert zurück, ohne dass ein zusätzliches Flag nötig wäre, um dem Host mitzuteilen, um welche Art von Adresse es sich handelt.
Schlüssel authentifizieren sich hier genauso wie überall sonst bei My Geocode: als X-API-Key-Header, als Authorization: Bearer-Header, per HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder als Query-Parameter. Welche Variante Ihre aktuelle Integration auch bereits verwendet, sie wird ohne Änderung akzeptiert.
Die Preise auf diesem Host entsprechen denen jedes anderen Hosts und Endpunkts, den wir betreiben. Jede Adresse erhält 2.500 kostenlose IP-Abfragen pro Tag ganz ohne Schlüssel, gezählt pro Netz. Ein Schlüssel fügt eigene, separate 2.500 kostenlose Anfragen pro Tag hinzu. Darüber hinaus kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt alles für 50 € im Monat ab, ohne Aufpreis für die Nutzung eines Kompatibilitäts-Hosts statt direkt /v1/ip.
Auch hier werden bei jeder Antwort Kontingent-Header mitgeliefert, etwas, das eine einfache ip-api.com-Integration normalerweise nicht von sich aus anzeigt: 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 sind alle enthalten.
Für Projekte, die mehr als eine Standardabfrage möchten, fügt mg_extras=1 in der Anfrage oder ein gesendeter X-MG-Extras-Header optionale Felder wie IP-Bedrohungs- und Netzwerkdetails zur kompatiblen Antwort hinzu, ohne deren Grundstruktur zu ändern, sofern Sie das nicht verlangen.
Alle Details finden Sie unter /compatibility/ip-api/. Wenn irgendwo in Ihrem Stack bereits ein Skript mit ip-api.com kommuniziert, ist die Umleitung hierher ein schneller Weg, den Unterschied zu sehen, den ein kontingentbewusster Host mit Preisen in EUR macht.