Événements

Envoyer des événements de tracking depuis votre serveur et consulter l’historique.

Les événements décrivent ce que font vos leads : page_view, checkout_started, order_paid… Ils alimentent vos segments et déclenchent vos parcours. Cet endpoint est la version serveur, authentifiée par clé secrète, de l’API de tracking : il utilise le même pipeline d’ingestion.

L'objet event

Champ Type Description
id string Identifiant de l’événement.
name string Nom de l’événement.
lead_id uuid | null Lead rattaché (null tant que le visiteur est anonyme).
anonymous_id string | null Identifiant anonyme du visiteur.
properties object Données libres de l’événement.
message_id string Identifiant de dédoublonnage (fourni ou généré).
timestamp datetime Moment de l’action.
received_at datetime Moment de la réception.

Envoyer un événement

POST /api/platform/v1/events events:write

Enregistre un événement pour un lead identifié par lead_id, email ou phone_number, ou pour un visiteur anonyme (anonymous_id). email et phone_number désignent un lead existant (sinon 404) : pour un visiteur inconnu, utilisez anonymous_id, ou créez d’abord le lead avec POST /leads. La requête est validée puis traitée de façon asynchrone : l’API répond 202 Accepted et l’événement est visible en général en quelques secondes.

Corps de la requête (JSON)

Champ Type Description
name requis string 1 à 128 caractères : lettres, chiffres, espaces, _ . : -.
lead_id uuid Lead de votre compte. Un identifiant parmi lead_id, email, phone_number, anonymous_id est requis.
email string Rattache l’événement au lead qui a cet email.
phone_number string Rattache l’événement au lead qui a ce numéro.
anonymous_id string Visiteur non identifié (64 caractères max.).
properties object Données libres, 16 Ko maximum une fois sérialisées.
timestamp datetime Moment de l’action (ISO 8601). Par défaut, l’heure de réception ; refusé à plus de 24 h dans le futur.
message_id string Identifiant unique (64 caractères max.) : un même message_id n’est enregistré qu’une fois. Généré si absent.

Utilisez un message_id dérivé de votre identifiant métier (par exemple order-CMD-1042) : un renvoi après une coupure réseau ne créera pas de doublon.

Exemple de requête

curl -X POST 'https://strikespace.net/api/platform/v1/events' \
  -H "Authorization: Bearer $STRIKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "name": "order_paid",
    "email": "awa@exemple.com",
    "properties": {
      "order_id": "CMD-1042",
      "amount": 25000,
      "currency": "XOF"
    },
    "timestamp": "2026-10-16T10:15:00Z",
    "message_id": "order-CMD-1042"
  }'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/events', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "name": "order_paid",
    "email": "awa@exemple.com",
    "properties": {
      "order_id": "CMD-1042",
      "amount": 25000,
      "currency": "XOF"
    },
    "timestamp": "2026-10-16T10:15:00Z",
    "message_id": "order-CMD-1042"
  }),
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import uuid
import requests

response = requests.post(
    "https://strikespace.net/api/platform/v1/events",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={
        "name": "order_paid",
        "email": "awa@exemple.com",
        "properties": {
            "order_id": "CMD-1042",
            "amount": 25000,
            "currency": "XOF",
        },
        "timestamp": "2026-10-16T10:15:00Z",
        "message_id": "order-CMD-1042",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/events');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'name' => 'order_paid',
        'email' => 'awa@exemple.com',
        'properties' => [
            'order_id' => 'CMD-1042',
            'amount' => 25000,
            'currency' => 'XOF',
        ],
        'timestamp' => '2026-10-16T10:15:00Z',
        'message_id' => 'order-CMD-1042',
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 202
{
  "object": "event",
  "status": "accepted",
  "name": "order_paid",
  "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
  "anonymous_id": null,
  "message_id": "order-CMD-1042",
  "timestamp": "2026-10-16T10:15:00.000Z"
}

Erreurs spécifiques

422 Paramètre invalide (invalid_request) ; param indique le champ en cause.
404 Lead (par lead_id, email ou phone_number) introuvable, ou appartenant à un autre compte (not_found).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Équivalent pour les agents IA : l'outil MCP track_event.

Lister les événements

GET /api/platform/v1/events events:read

Retourne les événements reçus, du plus récent au plus ancien.

Paramètres de requête

Champ Type Description
lead_id uuid Événements d’un lead.
name string Nom exact de l’événement.
since datetime Reçus à partir de cette date (ISO 8601).
limit integer Nombre d’éléments par page, de 1 à 100. Par défaut 25.
cursor string Valeur next_cursor de la page précédente. Voir Pagination.

Exemple de requête

curl 'https://strikespace.net/api/platform/v1/events?name=checkout_started&since=2026-10-01T00%3A00%3A00Z' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/events?name=checkout_started&since=2026-10-01T00%3A00%3A00Z', {
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/events",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    params={
        "name": "checkout_started",
        "since": "2026-10-01T00:00:00Z",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/events?name=checkout_started&since=2026-10-01T00%3A00%3A00Z');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "list",
  "data": [
    {
      "object": "event",
      "id": "418230",
      "name": "checkout_started",
      "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
      "anonymous_id": "a1b2c3d4",
      "properties": {
        "cart_total": 25000,
        "currency": "XOF"
      },
      "message_id": "b7c9e1f2-3a4d-4e5f-8a9b-0c1d2e3f4a5b",
      "timestamp": "2026-10-15T15:58:02.000Z",
      "received_at": "2026-10-15T15:58:03.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Erreurs spécifiques

422 Paramètre invalide (invalid_request) ; param indique le champ en cause.

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Une question sur l'intégration ? Écrivez à contact@strike.app en indiquant l'endpoint, l'heure et le request_id de la réponse.