Watch-IP

API-referentie voor bulk IP-lookup

POST/v1/lookup

Batchversie van GET /v1/lookup/{ip} — herleidt tot 100 IPv4/IPv6-adressen in één enkel backendverzoek, teruggegeven in dezelfde volgorde als waarin ze zijn ingediend.

Authenticatie

Geef een geheime sleutel mee via Authorization: Bearer YOUR_SECRET_KEY, hetzelfde sleuteltype als het endpoint voor het opzoeken van één IP.

Body van het verzoek

ips
Een array van 1–100 IPv4/IPv6-adresstrings. De hele batch wordt gevalideerd voordat er iets wordt opgezocht — één onjuist geformatteerd adres laat de hele aanroep mislukken.

Foutmeldingen

400
Een lege ips-array, meer dan 100 IP's, of een onjuist geformatteerd IP ergens in de array.
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 \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips": ["203.0.113.1", "2001:db8::1"]}'

Antwoord

{
  "results": [
    { "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 },
    { "ip": "2001:db8::1", "country": null, "region": null, "city": null, "postalCode": null, "latitude": null, "longitude": null, "continent": null, "timezone": null, "found": false }
  ]
}

Limieten

Elk IP in de batch wordt afzonderlijk in rekening gebracht en geregistreerd — een aanroep met 100 IP's registreert 100 lookup-gebruiksgebeurtenissen, niet één. Een IP dat twee keer wordt ingediend, wordt twee keer in rekening gebracht. Voor de rate limit per minuut telt de hele aanroep als één verzoek. Locatiegegevens voor dit endpoint worden geleverd door DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Gerelateerde pagina's