Watch-IP

Kimlik Doğrulama

Watch-IP, hangi endpoint'i çağırdığınıza bağlı olarak iki anahtar türü kullanır — istemci tarafı çağrılar için tarayıcı açısından güvenli bir yayınlanabilir anahtar, sunucu tarafı çağrılar için ise yalnızca sunucuda kullanılan bir gizli anahtar. Yanlış türün gönderilmesi, kısmi bir yanıt değil, her zaman 401 veya 403 döndürür.

Yayınlanabilir anahtarlar (tarayıcı açısından güvenli)

GET /v1/geo ve POST /v1/email/validate için kullanılır — her ikisi de doğrudan bir ziyaretçinin tarayıcısından çağrılmak üzere tasarlanmıştır. Anahtarı X-Api-Key başlığı olarak gönderin (GET /v1/geo, alternatif olarak bir key sorgu parametresini de kabul eder). Bu anahtar bir sır değildir: sayfanızın JavaScript'i içinde herkese açık şekilde yer alır; burada asıl önemli olan kontrol, anahtar için yapılandırılmış izin verilen origin listesinin, isteğin Origin/Referer başlığıyla karşılaştırılmasıdır. Bu listede olmayan bir origin'den gelen istek, CORS başlığı ayarlanmadan 403 alır — tarayıcı, kodunuz yanıtı hiç görmeden yanıtı engeller; asıl uygulanan kontrol budur, JSON hata gövdesi değil.

Yayınlanabilir anahtar

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

Gizli anahtarlar (yalnızca sunucu)

GET /v1/lookup/{ip}, POST /v1/lookup ve POST /v1/risk/check için kullanılır — bunların hepsi kontrol edilecek bir tarayıcı Origin'i olmayan, sunucudan sunucuya endpoint'lerdir. Anahtarı yalnızca kendi sunucu tarafınızdan Authorization: Bearer YOUR_SECRET_KEY olarak gönderin; bir gizli anahtarı asla bir sayfaya, mobil uygulama paketine veya kontrolünüzde olmayan herhangi bir istemciye gömmeyin. Yayınlanabilir bir anahtarın gizli anahtar rotasında ya da gizli bir anahtarın yayınlanabilir anahtar rotasında kullanılması 403 döndürür.

Gizli anahtar

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

Hız sınırlama

Her anahtar, rota bazında değil, çağırdığınız her endpoint arasında paylaşılan, sabit bir dakikalık pencerede müşteri hesabı başına hız sınırlandırılır. Bu sınırın aşılması 429 döndürür — yanıt biçimi ve nasıl geri çekileceğiniz için hatalar ve hız sınırları sayfasına bakın. 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.

Özel alan adları

Growth ve Scale planları, dashboard'da bir özel alan adı kurulum yolu içerir; böylece istekler api.watch-ip.com yerine kendi alan adınızdaki bir ana bilgisayar adına gidebilir. Kullanılabilirlik hesap uygunluğuna ve başarılı bir DNS/SSL kurulumuna bağlıdır — entegrasyonunuzu, dashboard'unuzun etkin olduğunu onayladığı temel URL'ye yönlendirin.

İlgili sayfalar