Watch-IP

Riferimento API della ricerca IP

GET/v1/lookup/{ip}

Risolve un singolo indirizzo IPv4 o IPv6 che fornisci, utilizzando un database di geolocalizzazione IP di terze parti — una fonte dati e un formato di risposta diversi da GET /v1/geo. Solo da server a server; chiamalo dal tuo backend, mai da un browser.

Autenticazione

Fornisci una chiave segreta tramite Authorization: Bearer YOUR_SECRET_KEY. A differenza della chiave pubblicabile usata da GET /v1/geo, questa chiave deve restare sul tuo server — usare qui una chiave pubblicabile restituisce 403.

Campi della risposta

ip
L'indirizzo IP che hai fornito, restituito così com'è.
country, city, continent
Posizione approssimativa dal database di origine, o null quando non disponibile.
region
Un codice di suddivisione (ad es. "TX"), non un nome di regione — un formato diverso dal campo region di GET /v1/geo.
postalCode, timezone
Non popolati dall'attuale database di origine — sempre null.
latitude, longitude
Coordinate approssimative, o null quando non disponibili.
found
False quando l'IP non ha un record corrispondente o il database sottostante è temporaneamente non disponibile — i due casi non sono distinti in questo campo.

Errori

400
L'IP fornito non è un indirizzo IPv4 o IPv6 valido.
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/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Risposta

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

Limiti

Fatturato per IP cercato, separatamente dal volume di richieste del tuo piano di geolocalizzazione visitatore — consulta la pagina prodotto della ricerca IP per prezzi e disponibilità. Ti serve più di un IP per chiamata? Usa invece l'endpoint batch. 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