ДокументацияБыстрый старт

Подключение за пару минут

Один JS-сниппет, и Trafvex начинает анализировать трафик. CMS-плагины не нужны.

1. Установка2. Проверка3. Серверная блокировка4. REST API5. Приватность

1. Установка трекера

Вставьте в <head> вашего сайта, как можно выше. Работает на WordPress, OpenCart, Tilda, 1С-Битрикс и на чистом HTML.

<script src="https://trafvex.com/tracker.js" data-site-id="ВАШ_SITE_ID" async></script>

SITE_ID берётся на экране подключения сайта в личном кабинете (кнопка «Проверить подключение» → «Для разработчиков»).

Через ваш домен (для посетителей из России)

Часть российских операторов обрывает соединения с Cloudflare, и у их абонентов трекер с trafvex.com не загружается. На PHP-сайте трекер, события и страницу проверки можно отдавать с вашего домена: скачайте trafvex_proxy.php, положите рядом с guard и его конфигом (строка 'pages' => '/tvx.php?p='), создайте в корне сайта tvx.php и поставьте код:

<?php // tvx.php в корне сайта define('TRAFVEX_PROXY_CONFIG', '/абсолютный/путь/trafvex_guard_config.php'); require '/абсолютный/путь/trafvex_proxy.php';
<script src="/tvx.php?p=/tracker.js" data-site-id="ВАШ_SITE_ID" data-api="/tvx.php?p=" async></script>

Если у посетителя не грузится Cloudflare Turnstile, страница проверки сама переключается на встроенную проверку браузера. Пошаговая инструкция есть на экране подключения сайта.

2. Проверка

Откройте сайт в браузере и загляните в личный кабинет, вкладка «Обзор», блок «Живой трафик»: ваша сессия появится в течение нескольких секунд. Трекер защищён try/catch и никогда не ломает страницу или оформление заказа.

3. Серверная защита (рекомендуется)

Трекер исполняет блокировку и проверку только у посетителей с JavaScript. Скрипты, curl и парсеры без браузера его не запускают. Серверная интеграция спрашивает Trafvex до того, как сайт отдаст страницу, и закрывает доступ и им: блокировка → 403, проверка → капча, превышение частоты → 429.

PHP (OpenCart, WordPress и др.): скачайте trafvex_guard.php, положите его рядом с конфигом вне папки сайта и подключите одной строкой. Код сайта менять не нужно. SECRET-ключ создаётся в «Аккаунт → Для разработчиков» (тип SECRET, привязка к сайту).

# .htaccess (PHP как модуль Apache) php_value auto_prepend_file "/абсолютный/путь/trafvex_guard.php" # или php.ini / .user.ini (PHP-FPM / CGI) auto_prepend_file = "/абсолютный/путь/trafvex_guard.php"

Свой бэкенд: передавайте IP и User-Agent посетителя вместе с SECRET-ключом, иначе Trafvex увидит IP вашего сервера.

POST https://trafvex.com/decision X-Api-Key: tg_sk_... { "siteId": "...", "visitorId": "<cookie tg_vid>", "ip": "<IP посетителя>", "userAgent": "<UA>", "hit": true } → { action: ALLOW | MONITOR | CHALLENGE | RATE_LIMIT | BLOCK, reasons[], challenge?, ttl }

Таймаут не больше 600 мс и fail-open: если Trafvex не ответил, сайт работает как обычно. RATE_LIMIT приходит, только пока посетитель превышает лимит в минуту.

4. REST API (для интеграций)

Для автоматизации (например, выгрузка заблокированных IP по расписанию) создайте API-ключ во вкладке Аккаунт → Для разработчиков и передавайте его в заголовке X-Api-Key. Ключ показывается один раз.

curl -H "X-Api-Key: ВАШ_КЛЮЧ" \ https://trafvex.com/api/v1/keyapi/sites/SITE_ID/exports/YANDEX # другие эндпоинты по ключу: GET https://trafvex.com/api/v1/keyapi/sites/SITE_ID/blocked-ips GET https://trafvex.com/api/v1/keyapi/sites/SITE_ID/exports/:platform # YANDEX | GOOGLE | VK | GENERIC

Ключ с доступом «Только сайт» работает лишь с этим сайтом. Отозванный или истёкший ключ возвращает 401.

5. Приватность

Собираем только поведенческие и технические сигналы и никогда не собираем содержимое форм или нажатые клавиши. Доступен режим hash-only-IP (сам IP-адрес не сохраняется) и настраиваемый срок хранения.

Создать аккаунт и получить код