İhtiyacınız olan API için bir plan seçin

Anahtar ve origin kontrolünü geçen her kimliği doğrulanmış çağrı bir istek sayılır: bir ziyaretçi konum tespiti çağrısı, sorgulanan her IP, kontrol edilen her e-posta adresi, her kayıt kontrolü ve her imkânsız seyahat kontrolü. Daha sonra girdi doğrulamasında başarısız olan bir çağrı da sayılır. Eksik veya geçersiz anahtar, izin verilmeyen origin ya da dakikalık hız sınırı nedeniyle reddedilen çağrılar sayılmaz; bir risk referansını silmek veya bir e-posta liste işinin durumunu sorgulamak da sayılmaz.

Bu, saat dakikasına hizalanmış sabit bir bir dakikalık penceredir — hareketli bir ortalama değildir. Free planda, örneğin 10:32:00 ile 10:32:59 arasında 30 isteğe kadar yapabilirsiniz; sayaç 10:33:00'te sıfırlanır. Sınırın aşılması, pencerenin ne zaman sıfırlanacağını saniye cinsinden bildiren bir Retry-After başlığıyla birlikte HTTP 429 döndürür. Bu, aşağıdaki aylık istek hacminizden bağımsızdır — toplam kullanımı değil, ani yük hızını sınırlar. Sınır öğeleri değil API çağrılarını sayar: en fazla 100 IP veya e-posta adresi içeren bir toplu istek ya da bir e-posta liste işi oluşturmak tek bir istek sayılır — ancak içindeki her IP veya adres aylık istek hacminize yine ayrı ayrı sayılır.

Anahtarınızı otomatik olarak kesmiyoruz. Planınızın üst sınırına sürekli yaklaşıyorsanız, kod veya API anahtarı değişikliği gerekmeden kontrol panelinizden istediğiniz zaman yükseltme yapabilirsiniz.

Ziyaretçi konum tespiti, edge istek verilerini okur ve bölgesel zenginleştirmeyi yerel olarak türetir; bu da maliyetini — ve fiyatını — çoğu sağlayıcının eşdeğer katmanlarının oldukça altında tutar. Sunucu taraflı IP sorgulaması ayrı satılmak yerine aynı plana ve fiyata dahil edilmiştir: her plan, o planın paylaşılan aylık havuzundan çekilen bir istek limiti ile bir IP sorgulama kotasını birlikte içerir.

Ziyaretçi konum tespiti ve IP sorgulama yanıtları, kaynak veri mevcut olduğunda bölgesel zenginleştirme içerir. Uygun planlar ayrıca liste tabanlı güvenlik göstergeleri içerir. E-posta kontrolleri alan adı düzeyinde ayrı bir sonuç döndürür. Gecikme, isteğe ve etkin özelliklere göre değişir.

Evet. GET /v1/geo, gerçekten bağlanan IP'yi çözümleyen, yalnızca istemci taraflı ziyaretçi kendi kendine sorgusu olarak kalır. Rastgele bir IP'yi sorgulamak için GET /v1/lookup/{ip} (tekli) ve POST /v1/lookup (toplu, çağrı başına en fazla 100 IP), yayınlanabilir anahtarınız yerine gizli bir anahtarla kimlik doğrulanan sunucudan sunucuya endpoint'lerdir — anahtar arka ucunuzda kalır ve bir tarayıcıya asla gönderilmez. Her ikisi de kendi gerçek zamanlı ağ verilerimiz yerine üçüncü taraf bir IP konum tespiti veritabanına dayanır, farklı bir yanıt yapısına sahiptir ve doğrulanmış bir bağıl doğruluk sıralaması yoktur — belirli sağlayıcı ve gereken atıf için veri kaynaklarına bakın — ve kullanım, sorgulanan IP başına, planınızın paylaşılan aylık havuzundan bir geo isteğiyle bire bir oranda ücretlendirilir (toplam sorgulama sayısına ilişkin ayrı üst sınır için yukarıdaki planınızın IP sorgulama kotasına bakın). Bu endpoint, ziyaretçinin kendi isteğiyle çağırdığı IP'ler yerine müşterinizin sağladığı IP'leri sorguladığından, bu durum Watch-IP'yi sizin adınıza bu üçüncü taraf verisinin işleyicisi yapar — bunun kendi uyumluluk yükümlülükleriniz için ne anlama geldiğini görmek için DPA'ya bakın.

POST /v1/risk/check, sağlanan bir IP'nin üçüncü taraf tarafından çözümlenen konumunu saklanan bir kullanıcı temeliyle karşılaştırır ve düşük/orta/yüksek risk ile bir impossibleTravel işareti döndürür. Bir sunucu tarafı Bearer gizli anahtarı kullanır. Kullanılabilirliği, sağlanmasını ve fiyatlandırmayı teyit etmek için bizimle iletişime geçin; bağımsız risk planı zorlaması ve ödeme hazırlığı henüz doğrulanmamıştır. VPN değişiklikleri ve mobil yönlendirme yanlış pozitiflere neden olabilir.

Evet. POST /v1/email/validate, origin ile sınırlı yayınlanabilir bir anahtarla sözdizimini, bilinen tek kullanımlık alan adlarını, alan adının bir posta sunucusu olup olmadığını, olası yazım hatalarını ve rol adreslerini kontrol eder ve gerekçeleriyle birlikte kabul, inceleme veya ret kararı döndürür. Arka ucunuzdan POST /v1/email/batch çağrı başına en fazla 100 adresi kontrol eder, liste işleri en fazla 100.000 adresi işler ve POST /v1/signup/check kaydolan IP'nin ağ sinyallerini ekler. Kontrol edilen her adres, planınızın aylık kotasından bir istek sayılır (bir liste işi her benzersiz adresi bir kez ücretlendirir). Bu kontrollerin hiçbiri posta kutusuyla iletişim kurmaz; bu nedenle posta kutusunun varlığını, sahipliğini veya teslim edilebilirliğini doğrulamaz.

Anahtar türüne bağlıdır. Yayınlanabilir anahtarlar — GET /v1/geo ve POST /v1/email/validate için — tıpkı bir Stripe veya Google Maps yayınlanabilir anahtarı gibi sayfa kaynağında yer almak üzere tasarlanmıştır; erişim denetimi origin kilitlemesidir: her anahtar yalnızca kaydettiğiniz alan adlarından çalışır ve CORS yalnızca eşleşen bir origin'e verilir. Gizli anahtarlar — IP sorgulama, toplu e-posta, kayıt ve imkânsız seyahat kontrolleri için — arka ucunuzda kalmalı ve asla tarayıcı kodunda görünmemelidir.

JavaScript/TypeScript, Python, PHP, Go ve Flutter/Dart için SDK kaynak paketleri mevcuttur. Kullanmadan önce paket kayıt kullanılabilirliğini ve uç nokta desteğini doğrulayın. GET /v1/geo her zaman bağlanan çağrıyı konumlandırır; sunucudan yapılan bir çağrı web sitesi ziyaretçinizi konumlandırmaz. Sağlanan bir IP için gizli anahtarlı sorgulamayı kullanın.

Evet, ancak bu isteğe bağlıdır: isteğe ?include=hostname ekleyin (veya SDK'da include: ["hostname"]) ve yanıt, bir DNS-over-HTTPS PTR sorgulamasıyla çözümlenen bir hostname alanı kazanır. PTR kaydı yoksa null olur. Yukarıdaki her zaman etkin zenginleştirme alanlarının aksine, bu istek içinde gerçek bir ağ sorgusu yapar, bu yüzden her çağrıya gecikme eklemek yerine varsayılan olarak kapalı bırakılmıştır.

Uygun planlar, liste tabanlı isVpn, isTor, isDatacenter, isThreat ve isSanctionedNetwork işaretlerini hem ziyaretçi konum tespiti hem de IP sorgulama yanıtlarında içerir; Free planında güvenlik bulunmaz. IPv4 liste ve ASN eşleştirmesini destekler. IPv6 VPN, veri merkezi ve tehdit aralıklarını ve ASN eşleştirmesini destekler, ancak Tor kapsamı yoktur. Üretimdeki kapsam, mevcut veri akışlarına bağlıdır. False, mevcut verilerde eşleşme olmadığı anlamına gelir, güvenlik garantisi değildir; bu sinyaller kesin bir yaptırım taraması değildir.

Evet — her yanıt bir compliance nesnesi içerir: isGDPR (AB/AEA + Birleşik Krallık), usPrivacyLaw (ziyaretçinin eyaletine göre belirlenen geçerli ABD eyalet yasası, ör. CCPA/CPRA veya VCDPA), isLGPD (Brezilya), türetilmiş bir requiresCookieConsent işareti, kaba bir dataResidencyZone ve isEmbargoedCountry (OFAC kapsamlı ülke ambargoları). Bu, tıpkı para birimi ve telefon kodu gibi her planda ek ücret olmadan dahildir. Bu, hukuki tavsiye değil, ziyaretçinin konumundan hesaplanan ilk aşama bir yargı alanı sinyalidir — uyumluluk gereksinimlerini her zaman kendi hukuk danışmanınızla teyit edin.

Evet — her yanıt bir locale nesnesi içerir: suggestedLocale, ziyaretçinin ülkesini tarayıcısının kendi Accept-Language başlığıyla birleştiren ve orada gerçekten konuşulan bir dili tercih eden bir BCP47 locale'idir (ör. Kanadalı bir ziyaretçiden gelen "fr" Accept-Language değeri "fr-FR" değil "fr-CA" verir); başlıkta hiçbir şey eşleşmezse ülkenin varsayılan locale'ine döner. Aynı nesne ayrıca measurementSystem (metrik/emperyal), firstDayOfWeek ve dateFormat içerir, böylece bölgesel biçimlendirme kurallarını kendiniz yeniden türetmek zorunda kalmazsınız. Her planda ek ücret olmadan dahildir.

Evet — her yanıt bir holiday nesnesi içerir: ziyaretçinin ülkesi için isPublicHolidayToday, todayHolidayName ve nextHoliday (tarih ve ad); bunlar istek anında hesaplanmak yerine Nager.Date'ten alınan, yılda bir veya iki kez elle güncellenen derlenmiş statik bir tablodan (şu anda ~40 ülke — G20 + AB/AEA + Birleşik Krallık) hesaplanır. Bu listenin dışındaki ülkeler için null'dur ve yalnızca ülke genelindeki resmi tatilleri sayar, eyalet/il düzeyindeki tatilleri değil. Her planda ek ücret olmadan dahildir; talep üzerine daha fazla ülke eklenebilir.

Statik eşlemeler, yaklaşık IP konumuna dayalı yaş ve yargı alanı ipuçları sağlar. Kimlik veya yaş doğrulaması yapmaz; geçerli gereksinimleri ayrıca teyit edin.