Перейти к содержимому

Опыт разработчика

Создано инженерами для инженеров

Три строки кода до идентификации устройств продакшен-уровня. Никаких конфигурационных файлов, никаких шагов сборки, никакой привязки к поставщику.

Быстрый старт

От нуля до отпечатка устройства за три строки. Работает с любым JavaScript-фреймворком.

app.js
// 1. Install
npm install @tracio/sdk
// 2. Initialize
import { Tracio } from '@tracio/sdk'
const tracio = Tracio.init({ publicKey: '5ca175fc...' })
// 3. Identify
const { visitorId } = await tracio.getResult()
Полное руководство по быстрому стартуAPI Playground

SDK и серверная интеграция

Официальные npm SDK для браузера, а также подписанные вебхуки, чтобы любой серверный язык мог обрабатывать события идентификации. Всё с открытым исходным кодом, всё типизировано.

Клиентские SDK

JSJavaScriptnpm install @tracio/sdk
REReactnpm install @tracio/react @tracio/sdk
VUVuenpm install @tracio/vue @tracio/sdk
NGAngularnpm install @tracio/angular @tracio/sdk
SVSveltenpm install @tracio/svelte @tracio/sdk

Серверная часть

Не нужно устанавливать серверный SDK — события идентификации доставляются на ваш бэкенд как подписанные вебхуки (HMAC-SHA256), поэтому подходит любой HTTP-стек. Чтобы прочитать историю по запросу, обращайтесь к Server API на api.tracio.ai/v1 со своим секретным ключом — доступно с тарифа Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

Возможности API

Всё, что нужно для продакшен-интеграции. Без сюрпризов.

Вебхуки

Уведомления о событиях на ваш сервер в реальном времени. Выберите, какие из четырёх типов событий получает эндпоинт; неудачные доставки повторяются автоматически в течение нескольких часов.

Лимиты запросов

Понятные лимиты с понятными заголовками: 10 запросов к Server API в секунду на Pro, 50 на Business, 200 на Enterprise. Каждый ответ сообщает, сколько у вас осталось.

Проверка подписи

Каждый вебхук подписывается HMAC-SHA256 (X-Tracio-Signature) по сырому телу и метке времени, обеспечивая доставку с защитой от повторов и подделки.

Server API

Смотрите историю посетителя, списки сессий и счётчики активности по HTTPS с секретным ключом (tracio_sk_…), передаваемым как Bearer-токен. Только чтение и только в рамках вашего рабочего пространства.

API в действии

Реальные примеры запросов/ответов. Копируйте, вставляйте, публикуйте.

Получить ключи подписи вебхуков

$ curl https://api.tracio.ai/.well-known/webhook-keys
{
  "keys": [
    {
      "kid": "k1",
      "alg": "Ed25519",
      "publicKey": "MCowBQYDK2VwAyEA9tR2v1kQ..."
    }
  ]
}

Найти посетителя

$ curl "https://api.tracio.ai/v1/visitors/X7fh2Hg9LkMn3pQr5tBvQw3xZa9mK2pL4nR8dT6y" \
  -H "Authorization: Bearer tracio_sk_XXXX...XXXX"
{
  "visitorId": "X7fh2Hg9LkMn3pQr5tBvQw3xZa9mK2pL4nR8dT6y",
  "firstSeenAt": "2026-02-01T08:11:00Z",
  "lastSeenAt": "2026-03-16T14:22:01Z",
  "visits": 14,
  "incognitoVisits": 2,
  "uniqueIps": 6,
  "uniqueCountries": 2,
  "risk": { "maxRiskScore": 63, "lastDecision": "real" },
  "network": {
    "vpnSeen": false,
    "proxySeen": false,
    "torSeen": false,
    "datacenterSeen": true
  },
  "meta": {
    "plan": "pro",
    "retentionDays": 30,
    "from": "2026-02-14T00:00:00Z",
    "to": "2026-03-16T14:30:00Z"
  }
}

Открытый код, открытый процесс

Наши SDK с открытым исходным кодом. Сообщайте об ошибках, отправляйте PR или просто читайте код. Прозрачность — часть продукта.

Поставьте нам звезду на GitHubПолная документация