Watch-IP

API-Referenz zur IP-Abfrage

GET/v1/lookup/{ip}

Löst eine einzelne von Ihnen angegebene IPv4- oder IPv6-Adresse anhand einer Geolokalisierungs- und ASN-Datenbank eines Drittanbieters auf — eine andere Datenquelle und Antwortform als GET /v1/geo. Nur für Server-zu-Server-Aufrufe; rufen Sie ihn von Ihrem Backend auf, niemals aus einem Browser.

Authentifizierung

Stellen Sie einen geheimen Schlüssel über Authorization: Bearer YOUR_SECRET_KEY bereit. Anders als der von GET /v1/geo verwendete veröffentlichbare Schlüssel muss dieser Schlüssel auf Ihrem Server bleiben — die Verwendung eines veröffentlichbaren Schlüssels hier liefert 403.

Antwortfelder

ip
Die von Ihnen angegebene IP-Adresse, unverändert zurückgegeben.
country, city, continent
Ungefährer Standort aus der Quelldatenbank, oder null, wenn nicht verfügbar.
region
Ein Subdivision-Code (z. B. „TX“), kein Regionsname — eine andere Form als das region-Feld von GET /v1/geo.
postalCode, timezone
Von der aktuellen Datenquelle nicht befüllt — immer null.
latitude, longitude
Ungefähre Koordinaten, oder null, wenn nicht verfügbar.
found
False, wenn die IP keinen passenden Eintrag hat oder die zugrunde liegende Datenbank vorübergehend nicht verfügbar ist — die beiden Fälle werden in diesem Feld nicht unterschieden.

Fehler

400
Die angegebene IP ist keine gültige IPv4- oder IPv6-Adresse.
401
Fehlender oder ungültiger API-Schlüssel.
403
Es wurde ein veröffentlichbarer statt eines geheimen Schlüssels verwendet.
429
Ratenlimit für das aktuelle Ein-Minuten-Fenster überschritten.

Beispiel

Anfrage

curl https://api.watch-ip.com/v1/lookup/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Antwort

{
  "ip": "203.0.113.1",
  "country": "US",
  "region": "TX",
  "city": "Austin",
  "postalCode": null,
  "latitude": 30.2672,
  "longitude": -97.7431,
  "continent": "NA",
  "timezone": null,
  "found": true
}

Limits

Abgerechnet pro nachgeschlagener IP, unabhängig vom Anfragevolumen Ihres Besucher-Geo-Tarifs — siehe die Produktseite zur IP-Abfrage für Preise und Verfügbarkeit. Benötigen Sie mehr als eine IP pro Aufruf? Verwenden Sie stattdessen den Batch-Endpoint. Standortdaten für diesen Endpoint werden von DB-IP bereitgestellt (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Verwandte Seiten