Recuperar datapoints

El navegador no necesita saber qué envía internamente sendClientTelemetry(externalIds?). Llame a la función, lea el token de sesión devuelto y deje que su backend use ese token de sesión con https://api.cside.com/token/v1/client o https://api.cside.com/token/v1/clientId para recuperar datapoints de identificación, bot, navegador, dispositivo, IP y entorno.

Flujo de extremo a extremo

1. El navegador llama a sendClientTelemetry(externalIds?).
2. sendClientTelemetry envía telemetría al CLIENT_URL configurado, normalmente /client.
3. /client devuelve JSON con la forma { "token": "..." }, donde token es el token de sesión de fingerprint.
4. Su backend usa ese token de sesión con https://api.cside.com/token/v1/client para el payload JSON completo o con https://api.cside.com/token/v1/clientId para el fingerprint ID estable.

Uso de sendClientTelemetry

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

if (!telemetryResponse?.ok) {
  throw new Error("La solicitud de telemetría de fingerprint falló.");
}

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

if (!sessionToken) {
  throw new Error("No se devolvió ningún token de sesión de fingerprint.");
}

Después de extraer sessionToken, envíelo a su backend. Su backend realiza el intercambio del token con cside.

También puede llamar a sendClientTelemetry() sin argumentos. Use externalIds solo cuando quiera adjuntar sus propios identificadores, como accountId, orderId o email, al fingerprint.

Opciones de recuperación

Método	Estado	Mejor para
API	Disponible	Decisiones en tiempo de solicitud y enriquecimiento backend
Exportación S3	Disponible cuando está habilitada	Análisis batch, data warehouse y revisión offline
Webhook	Planificado o habilitado por cuenta	Entrega push hacia sistemas internos
WebSocket	Planificado o habilitado por cuenta	Streams live y dashboards casi en tiempo real

Recuperación por API con el token de sesión

El token de sesión no contiene el payload fingerprint completo. Úselo directamente como token de lookup con los endpoints de token de cside.

Use /token/v1/client cuando necesite el payload JSON completo.

Consulte la referencia de respuesta de la Events API para ver un ejemplo de salida de la llamada API.

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

Use /token/v1/clientId cuando solo necesite el fingerprint ID estable.

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

Envíe el token de sesión sin procesar en el body de la request. No envuelva el token de sesión en JSON.

El endpoint clientId devuelve texto plano. Si no existe un fingerprint ID para el token de sesión, devuelve 404.

Ejemplo de request 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();

Use /token/v1/clientId cuando solo necesite un fingerprint ID estable para almacenamiento o joins. Use /token/v1/client cuando necesite el paquete completo de datapoints para tomar decisiones.

Exportación S3

cside puede exportar registros de fingerprint a S3 cuando la exportación fingerprint S3 está configurada para un dominio. Use esto para workflows batch donde no necesite una decisión en tiempo de solicitud.

Los registros exportados incluyen transaction ID, dominio del cliente, timestamp, referencia del cliente e identificador de fingerprint.

Webhooks

La entrega por webhook está planificada o habilitada para cuentas seleccionadas. Use webhooks cuando su sistema deba recibir nuevos datapoints sin consultar la API.

Buenos casos de uso para webhooks:

• Enviar eventos de fingerprint a una cola de fraude
• Enriquecer un SIEM o pipeline de datos
• Activar workflows de revisión para sesiones sospechosas

Streams WebSocket

La entrega por WebSocket está planificada o habilitada para cuentas seleccionadas. Úsela cuando necesite un feed live para dashboards, herramientas de operaciones o investigación activa.