Récupérer les datapoints

Le navigateur n’a pas besoin de savoir ce que sendClientTelemetry(externalIds?) envoie en interne. Appelez la fonction, lisez le token de session renvoyé et laissez votre backend utiliser ce token de session avec https://api.cside.com/token/v1/client ou https://api.cside.com/token/v1/clientId pour récupérer les datapoints d’identification, bot, navigateur, appareil, IP et environnement.

Flux de bout en bout

1. Le navigateur appelle sendClientTelemetry(externalIds?).
2. sendClientTelemetry envoie la télémétrie au CLIENT_URL configuré, généralement /client.
3. /client renvoie un JSON de la forme { "token": "..." }, où token est le token de session de fingerprint.
4. Votre backend utilise ce token de session avec https://api.cside.com/token/v1/client pour le payload JSON complet ou avec https://api.cside.com/token/v1/clientId pour l’ID stable de fingerprint.

Utiliser sendClientTelemetry

const telemetryResponse = await sendClientTelemetry({
  email: "user@example.com",
  accountId: "1234567890",
});

if (!telemetryResponse?.ok) {
  throw new Error("La requête de télémétrie fingerprint a échoué.");
}

const { token: sessionToken } = await telemetryResponse.json();

if (!sessionToken) {
  throw new Error("Aucun token de session de fingerprint renvoyé.");
}

Après avoir extrait sessionToken, envoyez-le à votre backend. Votre backend effectue l’échange du token de session avec cside.

Vous pouvez aussi appeler sendClientTelemetry() sans argument. Utilisez externalIds uniquement lorsque vous voulez associer vos propres identifiants, comme accountId, orderId ou email, au fingerprint.

Options de récupération

Méthode	Statut	Idéal pour
API	Disponible	Décisions à la requête et enrichissement backend
Export S3	Disponible lorsque configuré	Analyse batch, data warehouse et revue offline
Webhook	Planifié ou activé par compte	Livraison push vers les systèmes internes
WebSocket	Planifié ou activé par compte	Flux live et tableaux de bord presque temps réel

Récupération API avec le token de session

Le token de session ne contient pas le payload fingerprint complet. Utilisez-le directement comme token de lookup avec les endpoints de token cside.

Utilisez /token/v1/client lorsque vous avez besoin du payload JSON complet.

Consultez la référence de réponse de l’Events API pour voir un exemple de sortie de l’appel API.

curl https://api.cside.com/token/v1/client \
  --request POST \
  --header "Content-Type: text/plain" \
  --data "$CSIDE_FINGERPRINT_SESSION_TOKEN"

Utilisez /token/v1/clientId lorsque vous avez seulement besoin de l’ID stable de fingerprint.

curl https://api.cside.com/token/v1/clientId \
  --request POST \
  --header "Content-Type: text/plain" \
  --data "$CSIDE_FINGERPRINT_SESSION_TOKEN"

Envoyez le token de session brut dans le body de la requête. N’enveloppez pas le token de session dans du JSON.

L’endpoint clientId renvoie du texte brut. Si aucun ID de fingerprint n’existe pour le token de session, il renvoie 404.

Exemple de requête backend :

const csideResponse = await fetch("https://api.cside.com/token/v1/client", {
  method: "POST",
  headers: { "Content-Type": "text/plain" },
  body: sessionToken,
});

const datapoints = await csideResponse.json();

Utilisez /token/v1/clientId lorsque vous avez seulement besoin d’un ID stable de fingerprint pour le stockage ou les jointures. Utilisez /token/v1/client lorsque vous avez besoin du paquet complet de datapoints pour prendre une décision.

Export S3

cside peut exporter les enregistrements de fingerprint vers S3 lorsque l’export fingerprint S3 est configuré pour un domaine. Utilisez-le pour les workflows batch qui ne nécessitent pas de décision à la requête.

Les enregistrements exportés incluent le transaction ID, le domaine client, le timestamp, la référence client et l’identifiant de fingerprint.

Webhooks

La livraison webhook est planifiée ou activée pour certains comptes. Utilisez les webhooks lorsque votre système doit recevoir les nouveaux datapoints sans interroger l’API.

Bons cas d’usage webhook :

• Envoyer les événements de fingerprint vers une file fraude
• Enrichir un SIEM ou pipeline de données
• Déclencher des workflows de revue pour les sessions suspectes

Flux WebSocket

La livraison WebSocket est planifiée ou activée pour certains comptes. Utilisez-la lorsque vous avez besoin d’un flux live pour dashboards, outils d’opérations ou investigations actives.