Vada al contenuto

Esperienza per sviluppatori

Creato da ingegneri, per ingegneri

Tre righe di codice per una device identification di livello produttivo. Nessun file di configurazione, nessuno step di build, nessun vendor lock-in.

Avvio rapido

Da zero al fingerprint del dispositivo in tre righe. Funziona con qualsiasi framework 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()
Guida completa all'avvio rapidoAPI Playground

SDK e integrazione server

SDK npm ufficiali per il browser, più webhook firmati che permettono a qualsiasi linguaggio server-side di consumare gli eventi di identificazione. Tutto open-source, tutto tipizzato.

SDK client

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

Lato server

Nessun SDK server da installare: gli eventi di identificazione vengono recapitati al suo backend come webhook firmati (HMAC-SHA256), così funziona qualsiasi stack HTTP. Per leggere la cronologia su richiesta, chiami la Server API su api.tracio.ai/v1 con la sua secret key, disponibile dal piano Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

Funzionalità API

Tutto ciò che serve per un'integrazione in produzione. Nessuna sorpresa.

Webhook

Notifiche di eventi in tempo reale verso il suo server. Scelga quali dei quattro tipi di evento riceve un endpoint; le consegne fallite vengono ritentate automaticamente nell'arco di diverse ore.

Limiti di frequenza

Limiti chiari con header chiari: 10 richieste Server API al secondo su Pro, 50 su Business, 200 su Enterprise. Ogni risposta indica quanto le resta.

Verifica della firma

Ogni webhook è firmato con HMAC-SHA256 (X-Tracio-Signature) sul corpo grezzo e su un timestamp, garantendo un recapito a prova di replay e di manomissione.

Server API

Consulti cronologia dei visitatori, elenchi di sessioni e contatori di velocity via HTTPS con una secret key (tracio_sk_…) inviata come Bearer token. Di sola lettura e limitata al suo workspace.

L'API in azione

Esempi reali di richiesta/risposta. Copi, incolli, spedisca.

Recuperare le chiavi di firma dei webhook

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

Cercare un visitatore

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

Open Source, processo aperto

I nostri SDK sono open-source. Segnali bug, invii PR o semplicemente legga il codice. La trasparenza è una funzionalità.

Metta una star su GitHubDocumentazione completa