Sporing af events

POST /v1/events/track er et offentligt, kun-skrivende endpoint bygget til at blive kaldt direkte fra en kundes eget website — det kan modtage events, men kan ikke læse noget tilbage, så det er sikkert at kalde med blot en offentlig nøgle, i modsætning til jeres primære API-nøgle.

Spor en enkelt event

curl -X POST https://api.wezend.com/v1/events/track \
  -H "Content-Type: application/json" \
  -d '{
    "public_key": "pk_live_...",
    "event": "product_viewed",
    "customer_ref": "cus_8823",
    "properties": { "sku": "DK-1180", "price": 499 }
  }'

En enkelt event returnerer 202 { "ok": true }.

Batch af events

{
  "public_key": "pk_live_...",
  "events": [
    { "event": "product_viewed", "customer_ref": "cus_8823", "properties": { "sku": "DK-1180" } },
    { "event": "add_to_cart", "customer_ref": "cus_8823", "properties": { "sku": "DK-1180", "qty": 1 } }
  ]
}

returnerer 202 { "accepted": 2, "rejected": 0 }.

Origin-begrænsning

I kan sende nøglen som X-ZC-Key i stedet for i body'en. Hver offentlig nøgle kan valgfrit begrænses til en tilladelsesliste af origins, så en lækket nøgle kun kan bruges til at sende events fra jeres eget domæne — en tom liste betyder alle origins.

Hvad sker der bagefter

Når events ankommer, genberegnes beregnede traits, og segment-medlemskab opdateres i realtid — enhver journey, der overvåger den trigger eller det segment, kan udløses øjeblikkeligt, uden et batch-job involveret.