Pular para o conteúdo

Experiência do desenvolvedor

Feito por engenheiros, para engenheiros

Três linhas de código para device identification de nível de produção. Sem arquivos de configuração, sem etapas de build, sem vendor lock-in.

Início rápido

De zero à impressão digital de dispositivo em três linhas. Funciona com qualquer 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()
Guia completo de início rápidoAPI Playground

SDKs e integração no servidor

SDKs npm oficiais para o navegador, além de webhooks assinados para que qualquer linguagem do lado do servidor consuma eventos de identificação. Todos open-source, todos tipados.

SDKs de cliente

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

Lado do servidor

Sem SDK de servidor para instalar — os eventos de identificação são entregues ao seu backend como webhooks assinados (HMAC-SHA256), então qualquer stack HTTP funciona. Para ler o histórico sob demanda, chame a Server API em api.tracio.ai/v1 com sua chave secreta, disponível a partir do plano Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

Recursos da API

Tudo o que você precisa para uma integração de produção. Sem surpresas.

Webhooks

Notificações de eventos em tempo real para o seu servidor. Escolha quais dos quatro tipos de evento um endpoint recebe; entregas que falham são repetidas automaticamente ao longo de várias horas.

Limites de requisições

Limites claros com headers claros: 10 requisições por segundo à Server API no Pro, 50 no Business, 200 no Enterprise. Toda resposta informa quanto ainda resta.

Verificação de assinatura

Todo webhook é assinado com HMAC-SHA256 (X-Tracio-Signature) sobre o corpo bruto e um timestamp, garantindo entrega à prova de replay e adulteração.

Server API

Consulte histórico de visitantes, listas de sessões e contadores de velocidade por HTTPS com uma chave secreta (tracio_sk_…) enviada como token Bearer. Somente leitura e com escopo no seu workspace.

API em ação

Exemplos reais de requisição/resposta. Copie, cole, publique.

Obter as Chaves de Assinatura de Webhook

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

Consultar um visitante

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

Código aberto, processo aberto

Nossos SDKs são open-source. Reporte bugs, envie PRs ou apenas leia o código. Transparência é um recurso.

Dê uma estrela no GitHubDocumentação completa