Цей переклад згенеровано машиною й очікує перевірки. Перейти на англійську
Панель

Документація 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"

Посібники

Рівні ризику

Кожен відвідувач отримує зрозумілий рівень ризику на основі своєї оцінки, щоб ваша команда могла діяти без зайвого занурення в деталі:

ОцінкаРівеньЗначення
0–19minimalЗвичайна поведінка, без тривожних ознак
20–39lowНезначні аномалії
40–59mediumЄ підозрілі сигнали
60–79highІмовірна автоматизація або підміна
80–100criticalСильні ознаки бота

Live Demo

Спробуйте фінгерпринтинг на собі: Live Demo

Панель керування

Керуйте своїм обліковим записом: Backoffice

Коротко

  • Версія SDK: 3.2.0 (Schema: 2026-01-10)
  • Розгортання: глобально розподілене для низької затримки всюди
  • Затримка: відвідувачі оцінюються значно менш ніж за десяту частину секунди
  • Аутентифікація: виконується SDK автоматично — нічого не потрібно налаштовувати
  • Стандартний інтервал збору: 7 днів (налаштовується)

Підтримка