Watch-IP

API-referentie voor IP-lookup

GET/v1/lookup/{ip}

Herleidt een enkel IPv4- of IPv6-adres dat je opgeeft, met behulp van een IP-geolocatiedatabase van een externe partij — een andere gegevensbron en antwoordvorm dan GET /v1/geo. Alleen server-naar-server; roep dit aan vanaf je backend, nooit vanuit een browser.

Authenticatie

Geef een geheime sleutel mee via Authorization: Bearer YOUR_SECRET_KEY. In tegenstelling tot de publiceerbare sleutel die GET /v1/geo gebruikt, moet deze sleutel op je server blijven — het gebruiken van een publiceerbare sleutel hier levert 403 op.

Antwoordvelden

ip
Het IP-adres dat je hebt opgegeven, teruggekaatst.
country, city, continent
Geschatte locatie uit de brondatabase, of null wanneer niet beschikbaar.
region
Een subdivisiecode (bijv. "TX"), geen regionaam — een andere vorm dan het region-veld van GET /v1/geo.
postalCode, timezone
Niet gevuld door de huidige brondatabase — altijd null.
latitude, longitude
Geschatte coördinaten, of null wanneer niet beschikbaar.
found
False wanneer het IP geen bijbehorend record heeft of de onderliggende database tijdelijk niet beschikbaar is — deze twee gevallen worden in dit veld niet van elkaar onderscheiden.

Foutmeldingen

400
Het opgegeven IP is geen geldig IPv4- of IPv6-adres.
401
Ontbrekende of ongeldige API-sleutel.
403
Er is een publiceerbare sleutel gebruikt in plaats van een geheime sleutel.
429
Rate limit overschreden voor het huidige venster van één minuut.

Voorbeeld

Verzoek

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

Antwoord

{
  "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
}

Limieten

Wordt per opgezocht IP in rekening gebracht, los van het verzoeksvolume van je visitor-geo-plan — zie de productpagina voor IP-lookup voor prijzen en beschikbaarheid. Heb je meer dan één IP per aanroep nodig? Gebruik dan het batch-endpoint. Locatiegegevens voor dit endpoint worden geleverd door DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Gerelateerde pagina's