É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
/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
{
"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
invalid_request) ; param indique le champ en cause.
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
/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
{
"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
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.