Sunucunuzdan bir IP adresini sorgulayın

Sağlanan bir IP adresini mevcut ülke, bölge, şehir ve yaklaşık koordinat verisine çözümleyin. Watch-IP'nin IP sorgulama API'si IPv4 ve IPv6 girdisini kabul eder ve üçüncü taraf bir IP konum tespiti veritabanı tarafından desteklenen bir JSON sonucu döndürür. Sunucunuzda gizli bir API anahtarı kullanın ve uygulamanızı açık eşleşmeler, eksik kayıtlar ve null olabilen konum alanları etrafında tasarlayın.

Sorgulama planlarını görüntüleyin Sorgulama erişimini görüşün →

Çözümlemek istediğiniz adresi sağlayın

Uygulamanız tarafından toplanan bir IP adresiyle GET /v1/lookup/{ip}'yi, Authorization: Bearer ve bir gizli anahtar ile kimliği doğrulanmış olarak çağırın. Sorgulama, isteği yapmak için kullanılan bağlantıyı değil, URL'deki adresi çözümler; bu da onu raporlama ve bölgesel zenginleştirme dahil, zaten IP adresleri içeren sunucu tarafı iş akışları için uygun hale getirir. Yönlendirilen (forwarded) başlıklara güvenmeden önce uygulamanızın bir son kullanıcının IP'sini nasıl elde ettiğini doğrulayın; yalnızca kontrol ettiğiniz proxy yoluna güvenin. Sıradan bir web sitesi ziyaretçisi entegrasyonu için, tarayıcı konum tespiti uç noktası yayınlanabilir bir anahtar ve bölgesel zenginleştirme ile farklı bir yol sunar.

Tek bir adresten bir toplu isteğe geçin

İş akışınız birkaç IP adresi içeriyorsa, toplu uç nokta tek bir istekte 100'e kadar adresi kabul eder ve sonuçları aynı sırada döndürür. Aynı sorgulama sonucu şeklini ve aynı sunucu tarafı gizli anahtar kimlik doğrulama modelini kullanır. Toplu işleme isteklerin nasıl gönderildiğini değiştirir — sorgulama kullanımı yine de IP başına ölçülür, bu yüzden bir toplu istek tek bir sorgulama kullanım birimi değildir.

Yaklaşık veri etrafında tasarlayın

Bir IP; paylaşılan bir ağ geçidini, barındırma ağını, VPN çıkışını veya mobil operatör bağlantısını temsil edebilir. Konum kayıtları eksik olabilir veya veri sağlayıcıları arasında farklılık gösterebilir. Sorgulamayı, sağladığınız adres için bağlam olarak kullanın; bir kişinin ikametgahının veya kimliğinin kanıtı olarak değil.

Yanıt alanları

ip: Bu sonuçla ilişkilendirilen girdi adresi.
found: Eşleşen bir veritabanı kaydı bulunup bulunmadığı. False ayrıca veritabanının kullanılamadığı veya yüklenmediği anlamına da gelebilir — adresin konum verisi olmadığını kanıtlamaz.
country, continent: Mevcut olduğunda ülke ve kıta kodları.
region: Mevcut eşlemeden bir alt bölge tanımlayıcısı, her zaman tam bir bölge adı değil.
city, latitude, longitude: Kaynak veritabanında mevcut olduğunda yaklaşık şehir ve koordinatlar.
postalCode, timezone: Mevcut kaynak veritabanı tarafından doldurulmaz — her zaman null.

Sunucu tarafı bir istek yapın

cURL — GET /v1/lookup/{ip}

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup/8.8.8.8' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}"

Önce sunucunuzun ortamında WATCH_IP_SECRET_KEY'i ayarlayın. 8.8.8.8 sözdizimsel olarak geçerli bir örnek adrestir; bu kod parçası onun için belirli bir ülke, şehir veya yanıt taahhüt etmez.

Sık sorulan sorular

Bu API'yi başka birinin IP adresini sorgulamak için kullanabilir miyim?

Uç nokta, sağlanan bir IP adresini kabul eder ve bir kişinin adını, tam adresini veya kimliğini değil, mevcut veritabanı konum verisini döndürür. Yalnızca işleme yetkiniz olan verileri kullanın.

IPv6'yı destekliyor mu?

Uç nokta IPv4 ve IPv6 girdisini doğrular. Geçerli bir adresin yine de bir veritabanı kaydı veya bazı konum alanları eksik olabilir.

Sorgulama saat dilimi, ASN veya VPN tespiti içeriyor mu?

Hayır. Mevcut sorgulama yanıtı ASN veya güvenlik göstergeleri içermez ve üçüncü taraf kaynak veritabanı saat dilimi veya posta kodu alanlarını doldurmaz. Bağlanan istemci modeli uygulamanıza uyuyorsa ziyaretçi konum tespitini ayrıca inceleyin.

İsteği tarayıcı JavaScript'inden gönderebilir miyim?

Hayır — bir sorgulama gizli anahtarını asla tarayıcı kodunda açığa çıkarmayın. Sorgulama çağrılarını sunucunuzdan yapın ve doğrudan tarayıcı konum tespiti için yayınlanabilir bir anahtarla ziyaretçi uç noktasını kullanın.

Bu, ücretsiz bir ziyaretçi anahtarına dahil mi?

Hayır. Sorgulama ayrı bir gizli anahtar ve plan ailesi kullanır; ücretsiz ziyaretçi planı sunucu tarafı sorgulamaya erişim vermez.

found: false ne anlama gelir?

Sorgulama eşleşen bir kayıt döndürmedi. Mevcut uygulamada bu, veritabanının kullanılamadığı veya yüklenmediği durumlarda da olabilir, bu yüzden "Konum kullanılamıyor" gösterin ve bu sonucu geçersiz girdi, kimlik doğrulama hataları ve hız sınırı hatalarından ayrı tutun.