Przejdź do treści

Doświadczenie deweloperskie

Stworzone przez inżynierów, dla inżynierów

Trzy linie kodu do produkcyjnej identyfikacji urządzeń. Bez plików konfiguracyjnych, bez kroków budowania, bez uzależnienia od dostawcy.

Szybki start

Od zera do fingerprintu urządzenia w trzech liniach. Działa z dowolnym frameworkiem 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()
Pełny przewodnik szybkiego startuPlayground API

SDK i integracja serwerowa

Oficjalne SDK npm dla przeglądarki oraz podpisane webhooki, dzięki którym dowolny język po stronie serwera może odbierać zdarzenia identyfikacji. Wszystko open-source, wszystko typowane.

Klienckie 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

Po stronie serwera

Brak serwerowego SDK do instalacji — zdarzenia identyfikacji są dostarczane do Twojego backendu jako podpisane webhooki (HMAC-SHA256), więc działa dowolny stos HTTP. Aby odczytać historię na żądanie, wywołaj Server API pod adresem api.tracio.ai/v1 ze swoim kluczem sekretnym — dostępne od planu Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

Funkcje API

Wszystko, czego potrzebujesz do integracji produkcyjnej. Bez niespodzianek.

Webhooki

Powiadomienia o zdarzeniach w czasie rzeczywistym na Twój serwer. Wybierz, które z czterech typów zdarzeń otrzymuje dany endpoint; nieudane dostarczenia są ponawiane automatycznie przez kilka godzin.

Limity zapytań

Jasne limity z czytelnymi nagłówkami: 10 żądań Server API na sekundę w planie Pro, 50 w Business, 200 w Enterprise. Każda odpowiedź raportuje, ile Ci zostało.

Weryfikacja podpisu

Każdy webhook jest podpisany za pomocą HMAC-SHA256 (X-Tracio-Signature) na podstawie surowego ciała i znacznika czasu, zapewniając dostarczanie odporne na powtórki i manipulacje.

Server API

Przeglądaj historię odwiedzającego, listy sesji i liczniki prędkości przez HTTPS, z kluczem sekretnym (tracio_sk_…) wysyłanym jako token Bearer. Tylko do odczytu i ograniczone do Twojego workspace.

API w akcji

Rzeczywiste przykłady żądań/odpowiedzi. Kopiuj, wklejaj, wdrażaj.

Pobierz klucze podpisujące webhooki

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

Wyszukaj odwiedzającego

$ 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"
  }
}

Otwarty kod, otwarty proces

Nasze SDK są open-source. Zgłaszaj błędy, przesyłaj PR-y lub po prostu czytaj kod. Transparentność to funkcja.

Daj nam gwiazdkę na GitHubPełna dokumentacja