Saltar al contenido

Experiencia de desarrollador

Creado por ingenieros, para ingenieros

Tres líneas de código para una identificación de dispositivos de nivel producción. Sin archivos de configuración, sin pasos de build, sin dependencia de un proveedor.

Inicio rápido

De cero a huella digital del dispositivo en tres líneas. Funciona con cualquier framework de 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()
Guía completa de inicio rápidoAPI Playground

SDKs e integración de servidor

SDKs oficiales de npm para el navegador, más webhooks firmados para que cualquier lenguaje de servidor pueda consumir eventos de identificación. Todo open source, todo tipado.

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 del servidor

No hay SDK de servidor que instalar: los eventos de identificación se entregan a su backend como webhooks firmados (HMAC-SHA256), así que funciona con cualquier stack HTTP. Para leer el historial bajo demanda, llame a la Server API en api.tracio.ai/v1 con su clave secreta, disponible a partir del plan Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

Funciones de la API

Todo lo que necesita para una integración de producción. Sin sorpresas.

Webhooks

Notificaciones de eventos en tiempo real a su servidor. Elija cuáles de los cuatro tipos de evento recibe cada endpoint; las entregas fallidas se reintentan automáticamente durante varias horas.

Límites de peticiones

Límites claros con encabezados claros: 10 peticiones por segundo a la Server API en Pro, 50 en Business y 200 en Enterprise. Cada respuesta informa de lo que le queda.

Verificación de firma

Cada webhook se firma con HMAC-SHA256 (X-Tracio-Signature) sobre el cuerpo sin procesar y una marca de tiempo, lo que le ofrece una entrega a prueba de replay y de manipulaciones.

Server API

Consulte el historial de visitantes, las listas de sesiones y los contadores de velocidad por HTTPS con una clave secreta (tracio_sk_…) enviada como token Bearer. Solo lectura y con alcance a su workspace.

La API en acción

Ejemplos reales de solicitud/respuesta. Copie, pegue, despliegue.

Obtener claves de firma de webhook

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

Buscar un 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"
  }
}

Open source, proceso abierto

Nuestros SDKs son open source. Reporte errores, envíe PRs o simplemente lea el código. La transparencia es una función.

Denos una estrella en GitHubDocumentación completa