Watch-IP

Hızlı Başlangıç

Birkaç dakika içinde çalışan bir GET /v1/geo çağrısı elde edin: bir anahtar oluşturun, bir istek yapın ve yanıtı okuyun.

Başlamadan önce

  • Bir Watch-IP hesabı — bu rehberi takip etmek için ücretsiz plan yeterlidir.
  • Bir fetch veya curl çağrısı ekleyebileceğiniz bir sayfa veya betik.

1. Bir hesap oluşturun ve bir anahtar alın

Kaydolun ve kontrol panelinizi açın. Her hesap yayınlanabilir bir ziyaretçi anahtarıyla başlar — izin verilen origin'lerini onu çağıracağınız siteyi (veya test ederken localhost'u) içerecek şekilde yapılandırın.

2. İlk isteğinizi yapın

X-Api-Key başlığında yayınlanabilir anahtarınızla GET /v1/geo'yu çağırın. Bir tarayıcıdan, bu ziyaretçinin kendi bağlantısını çözümler; bir sunucudan ise bunun yerine sunucunun kendi bağlantısını çözümler.

curl

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

3. Yanıtı okuyun

Başarılı bir çağrı, bir JSON gövdesiyle 200 döndürür — country, city ve timezone çoğu entegrasyonun başladığı alanlardır ve her alan bağımsız olarak null olabilir, bu yüzden kullanmadan önce kontrol edin.

Yanıt (kısaltılmış)

{
  "ip": "203.0.113.1",
  "country": "US",
  "city": "Austin",
  "timezone": "America/Chicago"
}

4. Farklı bir IP'yi sorgulayın

Bağlanan ziyaretçi yerine zaten sahip olduğunuz bir adresi çözümlemeniz mi gerekiyor? Bu, yayınlanabilir anahtarınız değil gizli bir anahtarla kimliği doğrulanan ayrı bir sunucudan sunucuya uç noktadır — IP sorgulama referansına bakın.

Bir şeyler ters giderse

401, API anahtarının eksik veya geçersiz olduğu anlamına gelir; GET /v1/geo'dan gelen bir 403 genellikle çağıran origin'in henüz anahtarın izin verilen origin listesinde olmadığı anlamına gelir. Durum kodlarının tam listesi için hatalar ve hız sınırları sayfasına bakın.

Sonraki adım

Anahtar türlerinin ve origin kilitlemesinin nasıl çalıştığını öğrenmek için kimlik doğrulamayı okuyun veya doğrudan entegre ettiğiniz yanıt için uç nokta referansına gidin.

İlgili sayfalar