Aller au contenu

Expérience développeur

Conçu par des ingénieurs, pour des ingénieurs

Trois lignes de code pour une identification d'appareils de niveau production. Pas de fichiers de configuration, pas d'étapes de build, pas de dépendance à un fournisseur.

Démarrage rapide

De zéro à l'empreinte numérique d'appareil en trois lignes. Fonctionne avec n'importe quel 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()
Guide de démarrage rapide completAPI Playground

SDK et intégration serveur

SDK npm officiels pour le navigateur, plus des webhooks signés pour que n'importe quel langage côté serveur puisse consommer les événements d'identification. Tout est open-source et typé.

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

Côté serveur

Aucun SDK serveur à installer — les événements d'identification sont livrés à votre backend sous forme de webhooks signés (HMAC-SHA256), donc n'importe quelle pile HTTP fonctionne. Pour lire l'historique à la demande, appelez la Server API sur api.tracio.ai/v1 avec votre clé secrète, disponible à partir du plan Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

Fonctionnalités de l'API

Tout ce dont vous avez besoin pour une intégration en production. Sans surprises.

Webhooks

Notifications d'événements en temps réel vers votre serveur. Choisissez lequel des quatre types d'événements un endpoint reçoit ; les livraisons échouées sont réessayées automatiquement pendant plusieurs heures.

Limites de débit

Des limites claires avec des en-têtes clairs : 10 requêtes Server API par seconde sur Pro, 50 sur Business, 200 sur Enterprise. Chaque réponse indique ce qu'il vous reste.

Vérification de signature

Chaque webhook est signé en HMAC-SHA256 (X-Tracio-Signature) sur le corps brut et un horodatage, ce qui vous garantit une livraison à l'épreuve du rejeu et infalsifiable.

Server API

Consultez l'historique des visiteurs, les listes de sessions et les compteurs de vélocité en HTTPS avec une clé secrète (tracio_sk_…) envoyée en jeton Bearer. En lecture seule, et limitée à votre espace de travail.

L'API en action

De vrais exemples de requête/réponse. Copiez, collez, déployez.

Récupérer les clés de signature

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

Rechercher un visiteur

$ 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, processus ouvert

Nos SDK sont open-source. Signalez des bugs, soumettez des PR ou lisez simplement le code. La transparence est une fonctionnalité.

Mettez une étoile sur GitHubDocumentation complète