Noxtica Dokümantasyonu
Noxtica dokümantasyonuna hoş geldiniz. Noxtica, gerçek ziyaretçileri otomatik ve sahte trafikten ayırt etmenize yardımcı olan bir bot tespit platformudur — böylece kayıtları, girişleri, ödeme adımlarını ve ürününüzün geri kalanını koruyabilirsiniz.
Noxtica nedir?
Noxtica, her ziyaretçinin tarayıcı ve cihazının doğal olarak ürettiği pek çok küçük sinyale bakar; ardından botları, otomasyon araçlarını ve şüpheli davranışları tespit etmek için bunları tutarlılık açısından çapraz kontrol eder. Gerçek kullanıcılar tutarlı bir tablo bırakır; sahteciler çelişkiler bırakır.
Temel Yetenekler
- Cihaz tanıma: Geniş bir tarayıcı ve cihaz sinyali yelpazesinden her ziyaretçiye ait, kararlı ve gizliliğe saygılı bir tablo oluşturun
- Bot tespiti: Bıraktıkları çelişkileri tespit ederek otomasyonu, başsız kurulumları ve bir şeymiş gibi yapan ziyaretçileri yakalayın
- Kalibre edilmiş risk skorlaması: Üzerinde eylem yapabileceğiniz 0-100 arası bir risk skoru, bir güven düzeyi ve sade dilli bir risk katmanı alın
- Gerçek zamanlı API: Ziyaretçinin riskini saniyenin onda birinden çok daha kısa sürede backend’inizden sorgulayın
- Çok kiracılı: Tek bir hesaptan birden fazla siteyi ve alan adını yönetin
Platform Bileşenleri
| Bileşen | Açıklama |
|---|---|
| Collector SDK | Web sitenize eklediğiniz küçük bir JavaScript kod parçacığı |
| Collector API | Ziyaretçileri anında puanlayan, küresel dağıtımlı servis |
| Backoffice | Analitik, API anahtarları ve yapılandırma için yönetim panosu |
| Server API | Backend’inizden ziyaretçi riskini sorgulamak için basit API |
Hızlı Başlangıç
1. Site Anahtarınızı Alın
Kayıt olduktan sonra Backoffice’a giriş yapın ve alan adınızı ekleyin. Size bir Site Anahtarı (pk_prod_...) sağlanacaktır.
2. Toplayıcıyı Ekleyin
Toplayıcıyı web sitenize yerleştirin:
<script
src="https://collect.noxtica.com/collector/noxtica.js"
data-site-key="pk_prod_your_site_key_here"
data-auto-init
data-auto-check-once
async
></script>
İçerik Güvenlik İlkesi
Siteniz içerik güvenlik ilkesi kullanıyorsa, toplayıcının ihtiyaç duyduğu her şeyi — kurcalamaya dirençli çalışma ortamı KHAN VM dahil — kapsaması için izin vermeniz gerekir.
Content-Security-Policy:
default-src 'self';
script-src 'self' 'wasm-unsafe-eval' https://collect.noxtica.com;
connect-src 'self' https://collect.noxtica.com;
Bunlardan biri eksikse toplayıcı çalışmaya devam eder ancak kurcalama koruması zayıflar. Tam referans ve sorun giderme için Başlarken → İçerik Güvenlik İlkesi bölümüne bakın.
3. Risk Skorlarını Alın
Toplayıcı risk değerlendirmelerini gerçek zamanlı olarak iletir:
document.addEventListener('noxtica:collected', function (e) {
console.log('Risk Score:', e.detail.score);
console.log('Risk Level:', e.detail.risk_level);
console.log('Flags:', e.detail.flags);
});
4. Sunucu Tarafı Sorgular (İsteğe Bağlı)
Sunucu tarafı kararlar için bir API anahtarı oluşturup cihazları sorgulayın:
curl -H "Authorization: Bearer sk_prod_your_api_key" \
"https://collect.noxtica.com/v1/device/DEVICE_ID"
Kılavuzlar
- Başlarken: SDK seçenekleri ve yapılandırması dahil eksiksiz kurulum kılavuzu
- Tarayıcı Çalışma Zamanı: SDK’nın tarayıcıda nasıl çalıştığı, önbellekleme, olaylar ve sorun giderme
- Backend Entegrasyonu: Ziyaretçi sorguları için sunucu tarafı API entegrasyonu
Risk Seviyeleri
Her ziyaretçi, ekibinizin ayrıntıları okumadan hareket edebilmesi için skoruna dayalı sade dilli bir risk seviyesi alır:
| Skor | Seviye | Anlamı |
|---|---|---|
| 0-19 | minimal | Normal davranış, kırmızı bayrak yok |
| 20-39 | low | Küçük anormallikler tespit edildi |
| 40-59 | medium | Bazı şüpheli sinyaller |
| 60-79 | high | Muhtemelen otomasyon veya kimlik taklidi |
| 80-100 | critical | Güçlü bot göstergeleri |
Canlı Demo
Kendi tarayıcınızla parmak izi deneyin: Canlı Demo
Pano
Hesabınızı yönetin: Backoffice
Bir Bakışta
- SDK Sürümü: 3.2.0 (Şema: 2026-01-10)
- Dağıtım: Her yerde düşük gecikme için küresel dağıtımlı
- Gecikme: Ziyaretçiler saniyenin onda birinden çok daha kısa sürede puanlanır
- Kimlik Doğrulama: SDK tarafından otomatik olarak yönetilir — yönetecek bir şey yok
- Varsayılan Toplama Aralığı: 7 gün (yapılandırılabilir)
Destek
- İletişim: Destek veya satış sorularınız için bize ulaşın
- Demo Talebi: Noxtica’yı iş başında görmek için demo talep edin