Watch-IP

Ziyaretçi Konum Belirleme API Referansı

GET/v1/geo

Bağlanan istemcinin mevcut konum ve zenginleştirme verilerini döndürür. Bir ziyaretçinin bağlantısını tanımlamak için onu ziyaretçinin tarayıcısından çağırın — uygulama sunucunuzdan yapılan bir istek, bunun yerine sunucunun kendi bağlantısını tanımlar.

Kimlik doğrulama

X-Api-Key başlığı üzerinden origin'e kilitli bir yayınlanabilir anahtar sağlayın, ya da alternatif olarak key sorgu parametresini kullanın. Erişim kontrolü, anahtarın gizli tutulmasından değil — zira tarayıcı kaynağında görünecek şekilde tasarlanmıştır — anahtar için yapılandırılmış ve isteğin Origin/Referer başlığıyla karşılaştırılan izin verilen origin listesinden gelir.

Yanıt alanları

ip
Bağlanan istemcinin IP adresi.
country, region, regionCode, city, postalCode, continent
Yaklaşık konum; altta yatan edge verisi bir konum çözümlemediğinde null olabilir.
latitude, longitude
Çözümlenen konum için yaklaşık koordinatlar; bir cihaz veya GPS konumu değildir.
timezone
IANA saat dilimi adı, ya da kullanılamıyorsa null.
isEUCountry
Boolean; konumsal bir bayraktır, yasal bir belirleme değildir.
asn, asOrganization
Altta yatan veri tarafından sağlandığında bağlanan ağ ve operatörü; aksi halde null.
currency, callingCode
Çözümlenen country'den türetilen bölgesel bağlam, ya da null.
locale, holidays, compliance, tax, ageVerification
İsteğe bağlı, türetilmiş zenginleştirme grupları; her biri bağımsız olarak null olabilir. Bunların hiçbiri yasal, vergisel veya kimlik belirlemesi değildir.
hostname
Yalnızca ?include=hostname ile istendiğinde bulunur; bir ters DNS sorgusu sonucudur, başarısız olursa null'dur.
security
Bunu içermeyen planlarda tamamen atlanır. Mevcut olduğunda: isTor, isVpn, isDatacenter, isThreat, isSanctionedNetwork — liste tabanlı göstergeler. IPv6 Tor tespiti şu anda uygulanmamıştır; false, risk yokluğu değil, mevcut verilerde eşleşme olmadığı anlamına gelir.

Hatalar

401
Eksik veya geçersiz API anahtarı.
403
İsteğin Origin/Referer'ı anahtarın izin verilen origin listesinde değil. Bu yanıtta bir CORS başlığı ayarlanmaz, bu yüzden tarayıcı, JSON gövdesinden bağımsız olarak onu engeller.
429
Geçerli sabit bir dakikalık pencere için hız sınırı aşıldı.

Örnek

İstek

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

Yanıt — örnek amaçlıdır; alanlar plana ve mevcut veriye göre değişir

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

Sınırlar

Planınızın aylık istek sınırına ve dakika başına hız sınırına tabidir — fiyatlandırma sayfasına bakın. Başarılı her çağrı bir geo kullanım olayı olarak kaydedilir.

İlgili sayfalar