IP adreslerini toplu olarak sorgulayın

Bir IP adresi listesini tek bir uç noktaya gönderin ve eşleşen bir konum sonuçları listesi alın. Watch-IP'nin toplu IP sorgulama API'si, sunucu tarafı zenginleştirme iş akışları için istek başına 100'e kadar IPv4 ve IPv6 adresi kabul eder. Gizli anahtarınızı sunucuda tutun, yanıtı girdi sırasında işleyin ve orijinal verinizle bağlantıyı kaybetmeden eksik kayıtları yönetin.

Sorgulama planlarını görüntüleyin Tekli IP sorgulamayla karşılaştırın →

Tek istek, 100'e kadar adres

Bir ips dizisi içeren bir JSON nesnesiyle POST /v1/lookup'ı kullanın. Kabul edilen her toplu istek en az bir, en fazla 100 adres içerir ve aynı listede geçerli IPv4 ve IPv6 adreslerini karıştırabilirsiniz. Yanıt, sıralı sorgulama sonuçlarını bir results dizisinde sarar; her sonuç, found ve null olabilen konum alanları dahil, tekli IP sorgulama şeklini kullanır.

Sonuçları kaynak kayıtlarınızla hizalı tutun

Başarılı bir toplu istek için API, her girdi adresi için aynı sırada bir sonuç döndürür. Sonuçları orijinal satırlarınıza geri bağlayabilmek için kendi kayıt tanımlayıcılarınızı gönderilen listeyle birlikte tutun. Bir kayıt bulunamadığında satırı koruyun ve konumu kullanılamıyor olarak işaretleyin; yalnızca bir alan eksik olduğunda sonucun geri kalanını saklayın. Eksik koordinatları sıfırla değiştirmeyin, çünkü bu, verinin yokluğunu yanıltıcı bir harita konumuna dönüştürür.

Göndermeden önce doğrulayın

Boş bir liste, 100 adresten büyük bir liste veya hatalı biçimlendirilmiş bir IP bir istek hatası üretir — hatalı biçimlendirilmiş bir adres, kalan girdiler için kısmi bir başarı sonucu üretmek yerine tüm toplu isteği reddeder. Girdiyi doğrulayın ve daha uzun listeleri göndermeden önce toplu isteklere bölün; bir yeniden denemenin yanlışlıkla tüm işi tekrarlamaması için tamamlanan toplu isteklerin bir kaydını tutun.

Toplu işlemenin neyi değiştirdiğini anlayın

Toplu işleme, bir listeyi göndermek için gereken HTTP isteği sayısını azaltır. Veri kaynağını değiştirmez, güvenlik alanları eklemez veya 100 sorgulamayı tek bir kullanım birimine dönüştürmez — sorgulama kullanımı, kabul edilen istekler için gönderilen IP başına kaydedilir, bu yüzden plan seçimi hem toplam sorgulama hacmini hem de istek hızını hesaba katmalıdır. Dakika başına hız sınırı öğeleri değil HTTP çağrılarını sayar: en fazla 100 IP veya e-posta adresi içeren bir toplu istek tek bir istek sayılır; her öğe ise aylık istek kotasına yine ayrı ayrı sayılır.

İstek ve yanıt şekli

ips: İstek gövdesi: 1-100 IPv4 veya IPv6 adresinden oluşan bir JSON dizisi.
results: Yanıt: gönderilen sırayla, girdi adresi başına bir giriş içeren sıralı bir dizi.
results[].found, results[].country, ...: Her sonuç, tekli IP sorgulama yanıtıyla aynı şekli ve null olabilirliği kullanır — bkz. IP sorgulama ürün sayfası.

Toplu bir istek gönderin

cURL — POST /v1/lookup

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"ips":["8.8.8.8","2001:4860:4860::8888"]}'

Bu gösterim adresleri belirli mevcut konum değerlerini ima etmez. Önce sunucunuzun ortamında WATCH_IP_SECRET_KEY'i ayarlayın.

Sık sorulan sorular

Bir toplu istekte kaç IP adresi sığar?

Mevcut üst sınır 100'dür. Daha uzun listeleri her biri 1-100 adres içeren isteklere bölün.

Bir toplu istek hem IPv4 hem IPv6 içerebilir mi?

Evet. Her adres geçerli olmalıdır ve veritabanı kapsamı adrese göre farklılık gösterebilir.

Sonuçlar girdi sırasında mı döndürülür?

Evet. Başarılı ve kabul edilmiş bir toplu istek, girdi adresi başına aynı sırada bir sonuç döndürür.

Bir IP hatalı biçimlendirilmişse ne olur?

İsteğin tamamı reddedilir. Göndermeden önce girdinizi doğrulayın — bu uç nokta hatalı biçimlendirilmiş girdi için kısmi başarı sağlamaz.

Bir toplu istek tek bir sorgulama olarak mı faturalandırılır?

Hayır. Kullanım IP başına ölçülür. Büyük bir işin maliyetini tahmin etmeden önce güncel sorgulama fiyatlandırmasını ve doğrulanmış faturalandırma örneklerini inceleyin.

Bir CSV dosyası yükleyebilir miyim?

Belgelenen uç nokta bir adres JSON dizisi kabul eder. Uygulamanız kendi CSV'sini okuyabilir ve toplu istekler gönderebilir; barındırılan bir CSV yükleme arayüzü bu API'nin bir parçası değildir.

Toplu sorgulama VPN veya Tor kontrolleri içeriyor mu?

Hayır. Mevcut toplu yanıt, üçüncü taraf konum tespiti veritabanı sonucudur. Ziyaretçi konum tespiti güvenlik göstergeleri, sorgulama yanıtlarında bulunmayan ayrı bir özelliktir.