Eine IP-Adresse von Ihrem Backend aus abfragen

Lösen Sie eine angegebene IP-Adresse zu verfügbaren Angaben zu Land, Region, Stadt und ungefähren Koordinaten auf. Die IP-Abfrage-API von Watch-IP akzeptiert IPv4- und IPv6-Eingaben und liefert ein JSON-Ergebnis auf Basis einer Geolokalisierungsdatenbank eines Drittanbieters. Verwenden Sie einen geheimen API-Schlüssel auf Ihrem Server, und bauen Sie Ihre Anwendung um eindeutige Treffer, fehlende Einträge und nullbare Standortfelder herum auf.

Abfrage-Tarife ansehen Zugriff auf die Abfrage besprechen →

Geben Sie die aufzulösende Adresse an

Rufen Sie GET /v1/lookup/{ip} mit einer von Ihrer Anwendung erfassten IP-Adresse auf, authentifiziert mit Authorization: Bearer und einem geheimen Schlüssel. Die Abfrage löst die Adresse in der URL auf, nicht die für die Anfrage verwendete Verbindung, was sie für Backend-Workflows geeignet macht, die bereits IP-Adressen enthalten, einschließlich Reporting und regionaler Anreicherung. Prüfen Sie, wie Ihre Anwendung die IP eines Endnutzers ermittelt, bevor Sie sich auf weitergeleitete Header verlassen; vertrauen Sie nur dem Proxy-Pfad, den Sie selbst kontrollieren. Für eine gewöhnliche Website-Besucher-Integration bietet der Browser-Geolokalisierungs-Endpoint einen anderen Weg mit einem veröffentlichbaren Schlüssel und regionaler Anreicherung.

Von einer einzelnen Adresse zu einem Batch übergehen

Wenn Ihr Workflow mehrere IP-Adressen enthält, akzeptiert der Batch-Endpoint bis zu 100 in einer einzigen Anfrage und liefert Ergebnisse in derselben Reihenfolge. Er verwendet dieselbe Abfrageergebnisstruktur und dasselbe serverseitige Authentifizierungsmodell mit geheimem Schlüssel. Batching ändert, wie Sie die Anfragen senden — die Abfragenutzung wird weiterhin pro IP gemessen, ein Batch ist also keine einzelne Nutzungseinheit der Abfrage.

Um ungefähre Daten herum bauen

Eine IP kann ein gemeinsames Gateway, ein Hosting-Netzwerk, einen VPN-Exit oder eine Mobilfunkverbindung darstellen. Standorteinträge können unvollständig sein oder sich zwischen Datenanbietern unterscheiden. Verwenden Sie die Abfrage als Kontext für die von Ihnen angegebene Adresse, nicht als Beleg für den Wohnsitz oder die Identität einer Person.

Antwortfelder

ip: Die diesem Ergebnis zugeordnete Eingabeadresse.
found: Ob ein passender Datenbankeintrag gefunden wurde. False kann auch bedeuten, dass die Datenbank nicht verfügbar ist oder nicht geladen wurde — es belegt nicht, dass für die Adresse keine Standortdaten existieren.
country, continent: Länder- und Kontinentcodes, sofern verfügbar.
region: Eine Kennung für eine Verwaltungseinheit aus der aktuellen Zuordnung, nicht immer ein vollständiger Regionsname.
city, latitude, longitude: Ungefähre Stadt und Koordinaten, sofern in der Quelldatenbank verfügbar.
postalCode, timezone: Von der aktuellen Datenquelle nicht befüllt — immer null.

Eine serverseitige Anfrage stellen

cURL — GET /v1/lookup/{ip}

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup/8.8.8.8' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}"

Legen Sie zunächst WATCH_IP_SECRET_KEY in der Umgebung Ihres Servers fest. 8.8.8.8 ist eine syntaktisch gültige Beispieladresse; dieser Ausschnitt verspricht dafür kein bestimmtes Land, keine bestimmte Stadt oder Antwort.

Häufig gestellte Fragen

Kann ich mit dieser API die IP-Adresse einer anderen Person nachschlagen?

Der Endpoint akzeptiert eine angegebene IP-Adresse und liefert verfügbare Standortdaten aus der Datenbank, keinen Namen, keine genaue Adresse und keine Identität einer Person. Verwenden Sie nur Daten, zu deren Verarbeitung Sie berechtigt sind.

Unterstützt es IPv6?

Der Endpoint validiert IPv4- und IPv6-Eingaben. Eine gültige Adresse kann dennoch keinen Datenbankeintrag oder einige Standortfelder haben.

Enthält die Abfrage Zeitzone, ASN oder VPN-Erkennung?

Nein. Die aktuelle Abfrageantwort enthält keine ASN- oder Sicherheitsindikatoren, und ihre Datenbankquelle eines Drittanbieters befüllt keine Zeitzonen- oder Postleitzahlenfelder. Prüfen Sie stattdessen die Besucher-Geolokalisierung, falls deren Modell des verbindenden Clients zu Ihrer Anwendung passt.

Kann ich die Anfrage aus Browser-JavaScript senden?

Nein — legen Sie niemals einen geheimen Abfrage-Schlüssel im Browser-Code offen. Stellen Sie Abfrageaufrufe aus Ihrem Backend, und verwenden Sie für die direkte Browser-Geolokalisierung den Besucher-Endpoint mit einem veröffentlichbaren Schlüssel.

Ist dies in einem kostenlosen Besucher-Schlüssel enthalten?

Nein. Die Abfrage verwendet einen separaten geheimen Schlüssel und eine separate Tariffamilie; der kostenlose Besucher-Tarif gewährt keinen Zugriff auf die serverseitige Abfrage.

Was bedeutet found: false?

Die Abfrage lieferte keinen passenden Eintrag. In der aktuellen Implementierung kann dies auch auftreten, wenn die Datenbank nicht verfügbar ist oder nicht geladen wurde — zeigen Sie daher „Standort nicht verfügbar“ an, und behandeln Sie dieses Ergebnis getrennt von ungültiger Eingabe, Authentifizierungsfehlern und Ratenbegrenzungsfehlern.