IP konum tespiti, e-posta kontrolleri ve oturum açma risk sinyalleri tek bir API'de.
Site ziyaretçilerinin konumunu tarayıcıdan belirleyin, arka ucunuzdan IP adreslerini sorgulayın, kayıt e-postalarındaki tek kullanımlık alan adlarını ve yazım hatalarını yakalayın ve oturum açmada imkânsız seyahati işaretleyin — hepsi tek bir plan ve tek bir aylık istek kotasıyla. Kart, bu sayfa isteğinin uç verilerini ve yerel zenginleştirmesini önizler; bir API yanıtı değildir.
request.cf216.73.216.231
- Koordinatlar
- 39.9612, -82.9988
- Saat dilimi
- America/New_York
- Posta kodu
- 43215
- Kıta
- NA
- Ağ
- Anthropic, PBC
- ASN
- AS16509
- Para birimi
- $ USD
- Telefon kodu
- +1
- Gün doğumu / gün batımı
- 7:49 / 18:42
- Cihaz
- —
- Güvenlik
- Kullanılamıyor — kontrol edilmedi
Göreviniz için doğru API'yi seçin
Ziyaretçiyi web sitenizde konumlandırın
İzin verilen origin'lerinizle sınırlı bir yayınlanabilir anahtar kullanarak ziyaretçi konum tespiti API'sini doğrudan tarayıcıdan çağırın. Daha alakalı bir deneyim önermek için yaklaşık ülke ve şehir verisini, saat dilimini ve mevcut bölgesel bağlamı kullanın.
Ziyaretçi konum tespitini inceleyin →Sunucunuzdan bir IP'yi sorgulayın
Uygulamanızda zaten bir IP adresiniz mi var? Sunucunuzdan IP sorgulama uç noktasına gönderin. İsteği bir gizli anahtar doğrular ve yanıt, üçüncü taraf bir konum tespiti veritabanından gelen konum alanlarını içerir.
IP sorgulama API'sini inceleyin →Bir IP adresi listesini işleyin
Tek bir toplu istekte 100'e kadar IP adresi gönderin ve raporlama, zenginleştirme ile diğer sunucu tarafı iş akışları için sıralı bir sorgulama sonucu listesi alın. Sorgulama kullanımı toplu istek başına değil, IP başına ölçülür.
Toplu IP sorgulamayı inceleyin →Kayıt sırasında e-posta adreslerini kontrol edin
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 edin; gerekçeleriyle birlikte kabul, inceleme veya ret kararı alın. Formunuzdan yayınlanabilir bir anahtarla çağırın ya da arka ucunuzdan veya panelden istek başına 100 adrese — veya 100.000 adrese kadar listelere — kadar kontrol edin.
E-posta kontrollerini keşfedin →Yeni bir kaydı tek çağrıda puanlayın
POST /v1/signup/check, e-posta kontrolünü kaydolan IP'nin ülkesi ve ağıyla, plana bağlı VPN, Tor ve veri merkezi göstergeleriyle ve e-posta alan adının yaşıyla birleştirerek 0–100 arası bir puan ve gerekçeli bir karar üretir. Puan kararınız için bağlamdır, kötüye kullanımın kanıtı değildir.
Kayıt kötüye kullanımı iş akışını görün →Oturum açmada imkânsız seyahati işaretleyin
POST /v1/risk/check, oturum açan IP'nin yaklaşık konumunu kullanıcının daha önce kaydedilmiş konumuyla karşılaştırır ve mesafeyi, geçen süreyi, örtük hızı ve bir risk düzeyini döndürür. Yanlış pozitif üretebilir ve hesap ele geçirildiğini kanıtlamaz.
İmkânsız seyahat tespitini keşfedin →Tarayıcı entegrasyonu örneği ve edge önizlemesi
Örnek, bir tarayıcıdan GET /v1/geo'nun nasıl çağrılacağını gösterir. Bu önizlemeyi üretmek için çalıştırılmamıştır. Konum bu sayfa isteğinden gelir; zenginleştirme yerel olarak türetilir. Eksik değerler kullanılamıyor demektir ve güvenlik kontrolleri çalıştırılmaz.
Örnek istek — çalıştırılmadı
import { WatchIP } from "@digitload/watch-ip-sdk";
const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();Sayfa isteği önizlemesi — bir API yanıtı değildir
{
"ip": "216.73.216.231",
"country": "US",
"region": "Ohio",
"regionCode": "OH",
"city": "Columbus",
"postalCode": "43215",
"latitude": 39.96118,
"longitude": -82.99879,
"continent": "NA",
"timezone": "America/New_York",
"isEUCountry": false,
"asn": 16509,
"asOrganization": "Anthropic, PBC",
"currency": {
"code": "USD",
"name": "US Dollar",
"symbol": "$"
},
"callingCode": "+1",
"compliance": {
"isGDPR": false,
"usPrivacyLaw": null,
"isLGPD": false,
"requiresCookieConsent": false,
"dataResidencyZone": "US",
"isEmbargoedCountry": false
},
"locale": {
"suggestedLocale": "en-US",
"measurementSystem": "imperial",
"firstDayOfWeek": 0,
"dateFormat": "MM/DD/YYYY"
},
"sun": {
"sunrise": "2026-10-23T11:49:40.834Z",
"sunset": "2026-10-23T22:42:44.749Z"
},
"holiday": {
"isPublicHolidayToday": false,
"todayHolidayName": null,
"nextHoliday": {
"date": "2026-11-11",
"name": "Veterans Day"
}
},
"age": {
"ageOfMajority": 18,
"drinkingAge": 21,
"adultContentVerificationRequired": true,
"jurisdictionNote": "HB 96 (2025)"
},
"tax": {
"jurisdictionCode": "US-OH",
"taxSystem": "US_SALES_TAX",
"rate": null
},
"userAgent": {
"browser": null,
"browserVersion": null,
"os": null,
"osVersion": null,
"deviceType": "bot"
}
}Ziyaretçi ve sunucu tarafı konum tespiti
Ziyaretçinin tarayıcısında yayınlanabilir bir anahtarla GET /v1/geo'yu kullanın. Sağlanan IP'ler için sunucunuzda gizli bir anahtarla GET /v1/lookup/{ip} veya POST /v1/lookup kullanın.
Tüm kontroller için tek plan
Konum tespiti, IP sorgulama ve e-posta, kayıt ve imkânsız seyahat kontrollerinin tümü aynı aylık istek kotasından düşer — çağrı, kontrol edilen IP veya adres başına bir istek. Ayrıca satın alınacak bir ürün yoktur ve Free dahil her plan iki anahtar türünü de oluşturabilir.
Alan adı düzeyinde e-posta kontrolleri
E-posta kontrolleri sözdizimine, alan adının tek kullanımlık olup olmadığına ve posta sunucusu kayıtlarına, olası yazım hatalarına ve rol adreslerine bakar. Posta kutusuyla asla iletişim kurmaz; bu nedenle hiçbir sonuç bir adresin var olduğunu veya e-posta alabildiğini doğrulamaz.
Origin'e kilitli anahtarlar
API anahtarınız, tıpkı bir Stripe veya Google Maps anahtarı gibi yayınlanabilirdir. İstekler yalnızca kayıtlı origin'lerinize sunulur ve CORS yalnızca onlara tanınır.
Edge konum tespiti
GET /v1/geo, bağlanan IP için ağ düzeyindeki konum verisini okur. IP konumu yaklaşıktır; yanıt süresi isteğe ve etkinleştirilen özelliklere bağlıdır.
Bölgesel zenginleştirme
Ziyaretçi yanıtları; para birimini, ülke kodunu, güneş doğuş/batış saatlerini ve cihaz ipuçlarını konumdan ve istek başlıklarından türetir. Kaynak veri bulunmadığında alanlar null olabilir.
Bölgesel uyumluluk ipuçları
Statik ülke ve bölge eşlemeleri uyumluluk ipuçları sağlar. Yasal yükümlülük oluşturmaz veya uyumluluk garanti etmez.
Locale belirleme, sizin yerinize yapılır
Her yanıt bir locale nesnesi içerir: en uygun BCP47 locale'i (ziyaretçinin ülkesini tarayıcısının Accept-Language başlığıyla birleştirerek — Kanada'daki Fransızca konuşan bir ziyaretçi fr-FR değil fr-CA alır), ölçüm sistemi, haftanın ilk günü ve tarih biçimi — bunu kendi i18n katmanınızda yeniden uygulamanıza gerek kalmaz.
Resmi tatil takvimi
Her yanıt bir holiday nesnesi içerir: bugünün ziyaretçinin ülkesinde resmi tatil olup olmadığı, adı ve bir sonraki yaklaşan tatil — "bugün kapalıyız" destek widget'ı metinleri, ödeme mesajları veya zamanlama mantığı için kullanışlıdır; ~40 ülkelik derlenmiş bir listeyi kapsar.
Yaş yargı alanı ipuçları
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.
Vergi yargı alanı ipuçları
Statik eşlemeler bölgesel vergi bağlamı sağlar. Bir vergi hesaplaması veya güncel tutulan bir vergi motorunun yerine geçmez.
SDK kaynak paketleri
Depo; JavaScript/TypeScript, Python, PHP, Go ve Flutter/Dart istemcilerini içerir. Uç nokta desteği değişir; kurulumdan önce belgelere bakın ve paket kullanılabilirliğini doğrulayın.
VPN, Tor ve ağ sinyalleri
Uygun ziyaretçi planları, liste tabanlı VPN, Tor, veri merkezi, tehdit ve yaptırım uygulanan ağ göstergelerini içerir. Yanlış bir işaret, mevcut verilerde eşleşme bulunmadığı anlamına gelir, güvenli bir ziyaretçi anlamına gelmez. IPv6 kapsamı kısmidir; IPv6 Tor kapsanmaz.
Markalı alt alan adları
Growth ve Scale, kontrol panelinde özel alan adı kurulum yolu içerir. Kullanılabilirlik, hesap uygunluğuna ve başarılı DNS ile SSL kurulumuna bağlıdır; entegrasyonlar yapılandırılmış temel URL'yi kullanmalıdır.
İmkânsız seyahat sinyali
POST /v1/risk/check, sağlanan bir IP'nin yaklaşık konumunu saklanan bir kullanıcı temeliyle karşılaştırır. Yanlış pozitif üretebilir ve hesap ele geçirmeyi kanıtlamaz. Kullanılabilirliği ve sağlanmasını teyit etmek için bizimle iletişime geçin.
Entegre etmeden önce yanıtı anlayın
Ziyaretçi ve sorgulama API'leri farklı istekleri karşılar ve farklı veriler döndürür. Ziyaretçi konum tespiti, bağlanan isteğin edge konum verisini kullanır ve buna bölgesel bağlam ekler. IP sorgulama ise sağladığınız adresi üçüncü taraf bir IP konum tespiti veritabanı kullanarak çözümler. Sorgulama yanıtları ziyaretçi konum tespitindeki zenginleştirmenin tamamını içermez — örneğin posta kodu ve saat dilimi mevcut veri kümesi tarafından sağlanmaz. E-posta, kayıt ve risk kontrolleri her biri gönderdiğiniz girdiyle çalışır — bir adres ya da bir kullanıcı kimliği ve IP — ve aşağıdaki her satır aynı aylık istek kotasından düşer.
| Göreviniz | Endpoint | Anahtar | Veri odağı |
|---|---|---|---|
| Bağlanan web sitesi ziyaretçisini konumlandırın | GET /v1/geo | Yayınlanabilir, origin ile sınırlı | Ziyaretçi konumu ve bölgesel bağlam |
| Sağlanan tek bir IP'yi sorgulayın | GET /v1/lookup/{ip} | Gizli Bearer anahtarı | Üçüncü taraf konum tespiti veritabanı sonucu |
| Sağlanan birden fazla IP'yi sorgulayın | POST /v1/lookup | Gizli Bearer anahtarı | 100'e kadar sıralı konum sonucu |
| Kayıt formunda bir e-posta adresini kontrol etmek | POST /v1/email/validate | Yayınlanabilir, origin ile sınırlı | Sözdizimi, tek kullanımlık alan adı, posta sunucusu ve yazım hatası sinyalleri, kararla birlikte |
| E-posta adreslerini toplu kontrol etmek | POST /v1/email/batch, /v1/email/jobs | Gizli Bearer anahtarı | İstek başına 100'e kadar veya eşzamansız liste işi başına 100.000'e kadar |
| Yeni bir kaydı puanlamak | POST /v1/signup/check | Gizli Bearer anahtarı | E-posta, IP ağı ve alan adı yaşı sinyallerinden 0–100 puan |
| Bir oturum açmayı önceki konumla karşılaştırmak | POST /v1/risk/check | Gizli Bearer anahtarı | Mesafe, örtük hız ve imkânsız seyahat işareti |
Sık sorulan sorular
Watch-IP benim sağladığım bir IP adresini konumlandırabilir mi?
Evet. Gizli anahtarla sunucu tarafı IP sorgulama API'sini kullanın. Tarayıcı ziyaretçi uç noktası ise bağlanan istemciyi konumlandırır ve sorgulanacak rastgele bir IP kabul etmez.
Watch-IP'yi tarayıcıda JavaScript'ten kullanabilir miyim?
Web sitenizin origin'i için yapılandırılmış bir yayınlanabilir anahtarla ziyaretçi konum tespitini kullanın. Gizli sorgulama anahtarları sunucunuzda kalmalı ve asla tarayıcı kodunda görünmemelidir.
IP konum tespiti, tarayıcının Geolocation API'siyle aynı şey midir?
Hayır. Watch-IP konumu bir IP bağlantısından tahmin eder. Tarayıcının Geolocation API'si, cihaz tarafından sağlanan konum için izin isteyebilen ayrı bir mekanizmadır.
IPv4 ve IPv6 adreslerini sorgulayabilir miyim?
Sorgulama uç noktaları, mevcut veritabanı kayıtlarına bağlı olarak geçerli IPv4 ve IPv6 adreslerini kabul eder. Güvenlik sinyali kapsamı ayrı bir konudur ve göstergeye ve IP sürümüne göre değişir.
Watch-IP'nin ücretsiz bir planı var mı?
Evet. Free planı aylık bir istek kotası ve daha küçük bir IP sorgulama kotası içerir; güncel sınırlar için fiyatlandırma sayfasına bakın. E-posta, kayıt ve imkânsız seyahat kontrolleri ayrı bir plan olmadan aynı kotadan düşer.
E-posta kontrolü bir posta kutusunun var olduğunu doğrular mı?
Hayır. Watch-IP sözdizimini, alan adını (tek kullanımlık listeler, posta sunucusu kayıtları, yaş) ve yazım hataları ile rol hesapları gibi adres kalıplarını kontrol eder. Posta sunucusuyla iletişim kurmaz; bu nedenle hiçbir sonuç bir posta kutusunun var olduğunu veya e-posta alabildiğini doğrulamaz.
E-posta ve risk kontrolleri ayrı bir plan gerektirir mi?
Hayır. Kontrol edilen her adres, kayıt kontrolü veya imkânsız seyahat kontrolü, konum tespiti ve sorgulama çağrılarınızla aynı aylık kotadan bir istek olarak sayılır. Arka uç uç noktaları, panelinizden oluşturduğunuz gizli bir anahtar kullanır.
Yanlış bir güvenlik işareti, ziyaretçinin güvenli olduğu anlamına mı gelir?
Hayır. Bu yalnızca kontrolün kullandığı verilerde bir eşleşme bulamadığı anlamına gelir. Eksik kapsam, listelenmemiş ağlar ve kullanılamayan sinyaller ayrıca değerlendirilmelidir.
İlk entegrasyonunuzu seçin
Bir web sitesi için ziyaretçi kılavuzuyla, bir arka uç uygulaması için IP sorgulama ürün sayfasıyla veya kayıt formunuz için e-posta kontrolüyle başlayın.