Watch-IP

IP Sorgulama API Referansı

GET/v1/lookup/{ip}

Üçüncü taraf bir IP konum tespiti ve ASN veritabanını kullanarak sağladığınız tek bir IPv4 veya IPv6 adresini çözümler — GET /v1/geo'dan farklı bir veri kaynağı ve yanıt biçimidir. Yalnızca sunucudan sunucuyadır; onu kendi sunucu tarafınızdan çağırın, asla bir tarayıcıdan çağırmayın.

Kimlik doğrulama

Authorization: Bearer YOUR_SECRET_KEY üzerinden gizli bir anahtar sağlayın. GET /v1/geo'nun kullandığı yayınlanabilir anahtarın aksine, bu anahtar sunucunuzda kalmalıdır — burada yayınlanabilir bir anahtar kullanmak 403 döndürür.

Yanıt alanları

ip
Sağladığınız IP adresi, olduğu gibi geri döndürülür.
country, city, continent
Kaynak veritabanından yaklaşık konum, ya da kullanılamıyorsa null.
region
Bir bölge adı değil, bir alt bölge kodudur (ör. "TX") — GET /v1/geo'nun region alanından farklı bir biçimdir.
postalCode, timezone
Mevcut kaynak veritabanı tarafından doldurulmaz — her zaman null'dur.
latitude, longitude
Yaklaşık koordinatlar, ya da kullanılamıyorsa null.
found
IP'nin eşleşen bir kaydı olmadığında veya altta yatan veritabanı geçici olarak kullanılamadığında false'dur — bu iki durum bu alanda ayırt edilmez.

Hatalar

400
Sağlanan IP, geçerli bir IPv4 veya IPv6 adresi değil.
401
Eksik veya geçersiz API anahtarı.
403
Gizli anahtar yerine yayınlanabilir bir anahtar kullanıldı.
429
Geçerli bir dakikalık pencere için hız sınırı aşıldı.

Örnek

İstek

curl https://api.watch-ip.com/v1/lookup/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Yanıt

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

Sınırlar

Sorgulanan IP başına, ziyaretçi-geo planınızın istek hacminden ayrı olarak faturalandırılır — fiyatlandırma ve kullanılabilirlik için IP sorgulama ürün sayfasına bakın. Çağrı başına birden fazla IP'ye mi ihtiyacınız var? Bunun yerine toplu endpoint'i kullanın. Bu endpoint için konum verisi DB-IP tarafından sağlanmaktadır (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

İlgili sayfalar