Watch-IP

Toplu IP Sorgulama API Referansı

POST/v1/lookup

GET /v1/lookup/{ip}'nin toplu sürümü — tek bir sunucu tarafı istekte en fazla 100 IPv4/IPv6 adresini, gönderildikleri sırayla döndürerek çözümler.

Kimlik doğrulama

Tekli IP sorgulama endpoint'iyle aynı anahtar türü olan Authorization: Bearer YOUR_SECRET_KEY üzerinden gizli bir anahtar sağlayın.

İstek gövdesi

ips
1-100 adet IPv4/IPv6 adres dizesinden oluşan bir dizi. Herhangi bir sorgulama çalışmadan önce toplu isteğin tamamı doğrulanır — hatalı biçimlendirilmiş tek bir adres tüm çağrıyı başarısız kılar.

Hatalar

400
Boş bir ips dizisi, 100'den fazla IP ya da dizide bir yerde hatalı biçimlendirilmiş bir IP.
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 \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips": ["203.0.113.1", "2001:db8::1"]}'

Yanıt

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

Sınırlar

Toplu istekteki her IP ayrı ayrı faturalandırılır ve kaydedilir — 100 IP'lik bir çağrı, bir değil 100 sorgulama kullanım olayı kaydeder. İki kez gönderilen yinelenen bir IP iki kez faturalandırılır. Dakika başına hız sınırı açısından çağrının tamamı tek bir istek sayılır. 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