Watch-IP

Riferimento API della ricerca IP in blocco

POST/v1/lookup

Versione batch di GET /v1/lookup/{ip} — risolve fino a 100 indirizzi IPv4/IPv6 in un'unica richiesta di backend, restituiti nello stesso ordine in cui sono stati inviati.

Autenticazione

Fornisci una chiave segreta tramite Authorization: Bearer YOUR_SECRET_KEY, lo stesso tipo di chiave dell'endpoint di ricerca a singolo IP.

Corpo della richiesta

ips
Un array di 1–100 stringhe di indirizzi IPv4/IPv6. L'intero batch viene convalidato prima che venga effettuata qualsiasi ricerca — un indirizzo malformato fa fallire l'intera chiamata.

Errori

400
Un array ips vuoto, più di 100 IP, o un IP malformato in un punto qualsiasi dell'array.
401
Chiave API mancante o non valida.
403
È stata usata una chiave pubblicabile invece di una chiave segreta.
429
Limite di frequenza superato per l'attuale finestra di un minuto.

Esempio

Richiesta

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"]}'

Risposta

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

Limiti

Ogni IP nel batch viene fatturato e registrato individualmente — una chiamata con 100 IP registra 100 eventi di utilizzo lookup, non uno solo. Un IP duplicato inviato due volte viene fatturato due volte. Per il limite di frequenza al minuto, l'intera chiamata conta come una sola richiesta. I dati di posizione per questo endpoint sono forniti da DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Pagine correlate