Parcours

Lire vos parcours comportementaux et y inscrire des leads.

Un parcours (Journey Builder) enchaîne délais, conditions et actions à partir d’un déclencheur : un événement ou l’entrée dans un segment. L’API permet aussi d’y inscrire un lead directement, par exemple depuis votre back-office.

L'objet journey

Champ Type Description
id uuid Identifiant du parcours.
name string Nom.
status string draft, active, paused ou archived.
trigger object type (event, segment ou null), event, segment_id.
entry_policy string once (une seule fois par lead) ou multiple.
version integer Version publiée.
enrollments object Uniquement sur GET /journeys/:id : nombre d’inscriptions par statut (active, waiting, completed, failed, exited).

Lister les parcours

GET /api/platform/v1/journeys journeys:read

Retourne les parcours du compte.

Paramètres de requête

Champ Type Description
status string draft, active ou paused.
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/journeys' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/journeys', {
  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/journeys",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/journeys');
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": "journey",
      "id": "1679091c-5a88-4faf-9b4c-2d7e8f3a6b15",
      "name": "Panier abandonné",
      "status": "active",
      "trigger": {
        "type": "event",
        "event": "checkout_started",
        "segment_id": null
      },
      "entry_policy": "once",
      "version": 3,
      "activated_at": "2026-09-15T08:00:00.000Z",
      "created_at": "2026-09-10T08:00:00.000Z",
      "updated_at": "2026-09-15T08:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

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

Récupérer un parcours

GET /api/platform/v1/journeys/:id journeys:read

Retourne un parcours et ses inscriptions par statut.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant du parcours.

Exemple de requête

curl 'https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15', {
  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/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15');
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": "journey",
  "id": "1679091c-5a88-4faf-9b4c-2d7e8f3a6b15",
  "name": "Panier abandonné",
  "status": "active",
  "trigger": {
    "type": "event",
    "event": "checkout_started",
    "segment_id": null
  },
  "entry_policy": "once",
  "version": 3,
  "activated_at": "2026-09-15T08:00:00.000Z",
  "created_at": "2026-09-10T08:00:00.000Z",
  "updated_at": "2026-09-15T08:00:00.000Z",
  "enrollments": {
    "active": 12,
    "waiting": 30,
    "completed": 214,
    "exited": 3
  }
}

Erreurs spécifiques

404 Parcours introuvable, ou appartenant à un autre compte (not_found).

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

Inscrire un lead dans un parcours

POST /api/platform/v1/journeys/:id/enrollments journeys:write

Inscrit le lead au début du parcours. Seuls les parcours active acceptent des inscriptions ; la politique d’entrée (once / multiple) est respectée. Émet journey.enrollment.created.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant du parcours.

Corps de la requête (JSON)

Champ Type Description
lead_id requis uuid Lead de votre compte à inscrire.

Exemple de requête

curl -X POST 'https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15/enrollments' \
  -H "Authorization: Bearer $STRIKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
  }'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15/enrollments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
  }),
})
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/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15/enrollments",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={
        "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15/enrollments');
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([
        'lead_id' => '8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80',
    ]),
]);
$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 201
{
  "object": "journey_enrollment",
  "id": "6512bd43-d9ca-4d6e-8a1b-9c2d3e4f5a60",
  "journey_id": "1679091c-5a88-4faf-9b4c-2d7e8f3a6b15",
  "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
  "status": "active",
  "current_node_id": "wait-1",
  "step": 0,
  "started_at": "2026-10-16T10:20:00.000Z",
  "completed_at": null
}

Erreurs spécifiques

404 Parcours ou lead introuvable, ou appartenant à un autre compte (not_found).
409 Parcours inactif (journey_inactive) ou vide (journey_empty), lead déjà passé par le parcours ou en cours (already_enrolled).

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

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

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