Watch-IP

Riferimento API di geolocalizzazione del visitatore

GET/v1/geo

Restituisce i dati di posizione e arricchimento disponibili per il client che si connette. Chiamalo dal browser di un visitatore per descrivere la connessione di quel visitatore — una richiesta dal server della tua applicazione descrive invece la connessione del server stesso.

Autenticazione

Fornisci una chiave pubblicabile con restrizione di origine tramite l'header X-Api-Key, oppure in alternativa il parametro di query key. Il controllo degli accessi deriva dall'elenco di origini consentite configurato per la chiave, verificato rispetto all'header Origin/Referer della richiesta — non dal mantenere segreta la chiave, dato che è pensata per comparire nel codice sorgente del browser.

Campi della risposta

ip
L'indirizzo IP del client che si connette.
country, region, regionCode, city, postalCode, continent
Posizione approssimativa, nullable quando i dati edge sottostanti non ne risolvono una.
latitude, longitude
Coordinate approssimative per la posizione risolta, non una posizione del dispositivo o GPS.
timezone
Nome del fuso orario IANA, o null quando non disponibile.
isEUCountry
Booleano; un indicatore di localizzazione, non una determinazione legale.
asn, asOrganization
La rete che si connette e il suo operatore, quando forniti dai dati sottostanti; altrimenti null.
currency, callingCode
Contesto regionale derivato dal paese risolto, o null.
locale, holidays, compliance, tax, ageVerification
Gruppi di arricchimento derivati opzionali, ciascuno nullable in modo indipendente. Nessuno di questi è una determinazione legale, fiscale o di identità.
hostname
Presente solo se richiesto tramite ?include=hostname; il risultato di una ricerca DNS inversa, null se fallisce.
security
Omesso interamente sui piani che non lo includono. Quando presente: isTor, isVpn, isDatacenter, isThreat, isSanctionedNetwork — indicatori basati su elenco. Il rilevamento Tor su IPv6 non è attualmente implementato; false significa nessuna corrispondenza nei dati disponibili, non un'assenza di rischio.

Errori

401
Chiave API mancante o non valida.
403
L'Origin/Referer della richiesta non è nell'elenco di origini consentite della chiave. Su questa risposta non viene impostato nemmeno alcun header CORS, quindi il browser la blocca indipendentemente dal corpo JSON.
429
Limite di frequenza superato per l'attuale finestra fissa di un minuto.

Esempio

Richiesta

curl https://api.watch-ip.com/v1/geo \
  -H "X-Api-Key: YOUR_PUBLISHABLE_KEY"

Risposta — a titolo illustrativo; i campi variano in base al piano e ai dati disponibili

{
  "ip": "203.0.113.1",
  "country": "US",
  "region": "Texas",
  "regionCode": "TX",
  "city": "Austin",
  "postalCode": "78701",
  "latitude": 30.2672,
  "longitude": -97.7431,
  "continent": "NA",
  "timezone": "America/Chicago",
  "isEUCountry": false,
  "asn": 12345,
  "asOrganization": "Example ISP",
  "currency": { "code": "USD", "name": "US Dollar", "symbol": "$" },
  "callingCode": "+1"
}

Limiti

Soggetto al limite mensile di richieste e al limite di frequenza per minuto del tuo piano — consulta i prezzi. Ogni chiamata riuscita viene registrata come un evento di utilizzo geo.

Pagine correlate