Перейти до вмісту

Досвід розробника

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

Три рядки коду до ідентифікації пристроїв продакшн-рівня. Жодних конфігураційних файлів, кроків збірки чи прив’язки до постачальника.

Швидкий старт

Від нуля до відбитка пристрою в три рядки. Працює з будь-яким 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

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

Офіційні npm SDK для браузера, а також підписані webhooks, щоб будь-яка серверна мова могла отримувати події ідентифікації. Усе з відкритим кодом, усе типізовано.

Клієнтські 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 — події ідентифікації доставляються на ваш бекенд у вигляді підписаних webhooks (HMAC-SHA256), тож працює будь-який HTTP-стек. Щоб прочитати історію на вимогу, звертайтеся до Server API за адресою api.tracio.ai/v1 зі своїм секретним ключем — доступно з тарифу Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

Можливості API

Усе необхідне для продакшн-інтеграції. Без сюрпризів.

Webhooks

Сповіщення про події в реальному часі на ваш сервер. Оберіть, який із чотирьох типів подій отримує ендпоінт; невдалі доставки повторюються автоматично протягом кількох годин.

Обмеження частоти

Чіткі ліміти з чіткими заголовками: 10 запитів до Server API за секунду на Pro, 50 на Business, 200 на Enterprise. Кожна відповідь повідомляє, скільки у вас лишилося.

Перевірка підпису

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

Server API

Переглядайте історію відвідувача, списки сесій і лічильники активності через HTTPS із секретним ключем (tracio_sk_…), що передається як Bearer-токен. Лише читання і лише в межах вашого робочого простору.

API у дії

Реальні приклади запитів/відповідей. Копіюйте, вставляйте, запускайте.

Отримати ключі підпису webhook

$ 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Повна документація