Документація Noxtica
Ласкаво просимо до документації Noxtica. Noxtica — це платформа виявлення ботів, яка допомагає відрізняти справжніх відвідувачів від автоматизованого і шахрайського трафіку — щоб ви могли захищати реєстрацію, вхід, оформлення замовлення та решту вашого продукту.
Що таке Noxtica?
Noxtica аналізує численні дрібні сигнали, які природньо виробляє браузер і пристрій кожного відвідувача, а потім перехресно перевіряє їх на узгодженість, щоб виявити ботів, інструменти автоматизації та підозрілу поведінку. Справжні користувачі залишають узгоджену картину; ті, хто підробляє, — суперечності.
Ключові можливості
- Розпізнавання пристроїв: формуйте стабільний, дружній до приватності профіль кожного відвідувача на основі широкого набору браузерних і пристроєвих сигналів
- Виявлення ботів: виявляйте автоматизацію, безголові браузери та відвідувачів, що прикидаються кимось іншим, — помічаючи суперечності, які вони залишають
- Калібрована оцінка ризику: отримуйте оцінку ризику від 0 до 100, рівень впевненості та зрозумілий рівень ризику, на який можна реагувати
- API у реальному часі: отримуйте оцінку ризику відвідувача з вашого бекенду менш ніж за десяту частину секунди
- Мультитенантність: керуйте кількома сайтами і доменами з одного облікового запису
Компоненти платформи
| Компонент | Опис |
|---|---|
| Collector SDK | Невеликий JavaScript-фрагмент, який ви додаєте на свій сайт |
| Collector API | Глобально розподілений сервіс, що миттєво оцінює відвідувачів |
| Backoffice | Адмін-панель для аналітики, API-ключів і конфігурації |
| Server API | Простий API для отримання оцінки ризику відвідувача з вашого бекенду |
Швидкий старт
1. Отримайте Site Key
Після реєстрації увійдіть до Backoffice і додайте свій домен. Ви отримаєте Site Key (pk_prod_...).
2. Додайте колектор
Вбудуйте колектор на свій сайт:
<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>
Content Security Policy
Якщо ваш сайт використовує content-security-policy, вам потрібно дозволити Noxtica завантажуватися і запускатися. Наведений нижче фрагмент охоплює все, що потрібно колектору — включно зі стійким до підробки рантаймом, KHAN VM.
Content-Security-Policy:
default-src 'self';
script-src 'self' 'wasm-unsafe-eval' https://collect.noxtica.com;
connect-src 'self' https://collect.noxtica.com;
Якщо в правилі відсутній один із цих елементів, колектор продовжить роботу, але зі слабшим захистом від підробки. Дивіться розділ Початок роботи → Content Security Policy для повного довідника і поrad з усунення проблем.
3. Отримуйте оцінки ризику
Колектор надає оцінку ризику в реальному часі:
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. Серверні запити (необов’язково)
Для рішень на боці сервера створіть API-ключ і запитуйте пристрої:
curl -H "Authorization: Bearer sk_prod_your_api_key" \
"https://collect.noxtica.com/v1/device/DEVICE_ID"
Посібники
- Початок роботи: повний посібник зі встановлення, включно з параметрами та конфігурацією SDK
- Рантайм у браузері: як SDK працює в браузері, кешування, події та усунення проблем
- Інтеграція з бекендом: серверна інтеграція API для запитів до відвідувачів
Рівні ризику
Кожен відвідувач отримує зрозумілий рівень ризику на основі своєї оцінки, щоб ваша команда могла діяти без зайвого занурення в деталі:
| Оцінка | Рівень | Значення |
|---|---|---|
| 0–19 | minimal | Звичайна поведінка, без тривожних ознак |
| 20–39 | low | Незначні аномалії |
| 40–59 | medium | Є підозрілі сигнали |
| 60–79 | high | Імовірна автоматизація або підміна |
| 80–100 | critical | Сильні ознаки бота |
Live Demo
Спробуйте фінгерпринтинг на собі: Live Demo
Панель керування
Керуйте своїм обліковим записом: Backoffice
Коротко
- Версія SDK: 3.2.0 (Schema: 2026-01-10)
- Розгортання: глобально розподілене для низької затримки всюди
- Затримка: відвідувачі оцінюються значно менш ніж за десяту частину секунди
- Аутентифікація: виконується SDK автоматично — нічого не потрібно налаштовувати
- Стандартний інтервал збору: 7 днів (налаштовується)
Підтримка
- Контакти: зв’яжіться з нами щодо питань підтримки або продажу
- Запит демо: запросіть демо, щоб побачити Noxtica у дії