Datapoints ophalen

De browser hoeft niet te weten welke payload sendClientTelemetry(externalIds?) verstuurt. Roep de functie aan, lees het geretourneerde sessietoken, en laat uw backend dat sessietoken gebruiken met https://api.cside.com/token/v1/client of https://api.cside.com/token/v1/clientId om identificatie-, bot-, browser-, apparaat-, IP- en omgevingsdatapoints op te halen.

End-to-end flow

1. De browser roept sendClientTelemetry(externalIds?) aan.
2. sendClientTelemetry verzendt telemetry naar het geconfigureerde CLIENT_URL, meestal /client.
3. /client retourneert JSON in de vorm { "token": "..." }, waarbij token het fingerprint-sessietoken is.
4. Uw backend gebruikt dat sessietoken met https://api.cside.com/token/v1/client voor de volledige JSON-payload of https://api.cside.com/token/v1/clientId voor de stabiele fingerprint-ID.

sendClientTelemetry gebruiken

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

if (!telemetryResponse?.ok) {
  throw new Error("Fingerprint telemetry-aanvraag is mislukt.");
}

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

if (!sessionToken) {
  throw new Error("Geen fingerprint-sessietoken ontvangen.");
}

Nadat u sessionToken hebt uitgehaald, stuurt u het naar uw backend. Uw backend voert de tokenuitwisseling met cside uit.

U kunt sendClientTelemetry() ook zonder argumenten aanroepen. Gebruik externalIds alleen wanneer u eigen identifiers, zoals accountId, orderId of email, aan de fingerprint wilt koppelen.

Ophaalopties

Methode	Status	Best voor
API	Beschikbaar	Beslissingen tijdens requests en backendverrijking
S3-export	Beschikbaar wanneer ingeschakeld	Batchanalyse, warehousing en offline review
Webhook	Gepland of account-enabled	Pushlevering naar interne systemen
WebSocket	Gepland of account-enabled	Live streams en bijna real-time dashboards

API ophalen met het sessietoken

Het sessietoken zelf bevat niet de volledige fingerprintdata. Gebruik het direct als lookup-token met de cside token-endpoints.

Gebruik /token/v1/client wanneer u de volledige JSON-payload nodig heeft.

Bekijk de responsreferentie van de Events API voor voorbeelduitvoer van de API-call.

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

Gebruik /token/v1/clientId wanneer u alleen de stabiele fingerprint-ID nodig heeft.

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

Stuur het ruwe sessietoken in de request body. Verpak het sessietoken niet in JSON.

Het clientId-endpoint retourneert platte tekst. Als er geen fingerprint-ID voor het sessietoken bestaat, retourneert het 404.

Voorbeeld van een backendrequest:

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();

Gebruik /token/v1/clientId wanneer u alleen een stabiele fingerprint-ID nodig heeft voor joins of opslag. Gebruik /token/v1/client wanneer u beslissingen wilt nemen op basis van het volledige datapointpakket.

S3-export

cside kan fingerprintrecords exporteren naar S3 wanneer fingerprint S3-export is geconfigureerd voor een domein. Gebruik dit voor batchworkflows waar u geen beslissing tijdens een request nodig heeft.

Geëxporteerde records bevatten transaction ID, klantdomein, timestamp, klantreferentie en fingerprint-ID.

Webhooks

Webhooklevering is gepland of ingeschakeld voor geselecteerde accounts. Gebruik webhooks wanneer uw systeem nieuwe datapoints moet ontvangen zonder de API te pollen.

Goede webhook-use cases:

• Fingerprintevents naar een fraudewachtrij sturen
• Een SIEM of datapipeline verrijken
• Reviewworkflows activeren voor verdachte sessies

WebSocket-streams

WebSocketlevering is gepland of ingeschakeld voor geselecteerde accounts. Gebruik dit wanneer u een live feed nodig heeft voor dashboards, operationele tools of actief onderzoek.