# STRIKE — documentation développeurs (texte intégral) > Version de l'API : 2026-10-01. API REST : https://strikespace.net/api/platform/v1. Serveur MCP : https://strikespace.net/mcp. > Spécification OpenAPI : https://strikespace.net/api/platform/v1/openapi.json. Index : https://strikespace.net/llms.txt # Documentation développeurs Source : https://strikespace.net/developpeurs API REST, webhooks signés et agents IA : intégrez STRIKE à votre stack. Votre entreprise a déjà son site, son CRM, son back-office ou ses outils d'automatisation ? Branchez-les sur STRIKE : vos leads, vos événements, vos relances, vos parcours, vos réseaux sociaux et vos paiements deviennent accessibles par programme, en toute sécurité. [API REST Lisez et écrivez vos données STRIKE depuis n'importe quel langage : JSON, pagination par curseur, idempotence.](https://strikespace.net/developpeurs/api) [Webhooks signés Soyez prévenu en temps réel : nouveau lead, paiement encaissé, publication en ligne… Signature HMAC et renvois automatiques.](https://strikespace.net/developpeurs/webhooks) [Agents IA (MCP) Connectez Claude, ChatGPT, Cursor ou VS Code à votre compte en un clic, avec des permissions que vous choisissez.](https://strikespace.net/developpeurs/agents-ia) [Tracking & SDK Envoyez les événements de votre site avec le SDK JavaScript et la clé publique `strk_`.](https://strikespace.net/developpeurs/tracking) ## Quelle intégration choisir ? Besoin Outil Authentification Suivre les visiteurs de votre site, depuis le navigateur [SDK JavaScript](https://strikespace.net/developpeurs/sdk-javascript) et [API de tracking v1](https://strikespace.net/developpeurs/tracking) Clé publique `strk_…` (écriture seule) Synchroniser votre CRM, votre ERP ou votre back-office [API REST](https://strikespace.net/developpeurs/api) Clé secrète `sk_live_…` + scopes Réagir aux événements STRIKE dans vos systèmes [Webhooks](https://strikespace.net/developpeurs/webhooks) Signature `Strike-Signature` (secret `whsec_…`) Piloter STRIKE en langage naturel avec un assistant IA [Serveur MCP](https://strikespace.net/developpeurs/agents-ia) OAuth 2.1 (consentement) ou clé API ## L'essentiel en un coup d'œil URL de base de l'API `https://strikespace.net/api/platform/v1` Serveur MCP `https://strikespace.net/mcp` Spécification OpenAPI 3.1 [`https://strikespace.net/api/platform/v1/openapi.json`](https://strikespace.net/api/platform/v1/openapi.json) Version `2026-10-01` (voir [Versions](https://strikespace.net/developpeurs/conventions#versions)) Offres API REST, webhooks et agents IA : Pro et Enterprise. SDK et API de tracking : dès Starter. Pour les agents IA [`/llms.txt`](https://strikespace.net/llms.txt) et [`/developpeurs/llms-full.txt`](https://strikespace.net/developpeurs/llms-full.txt) ## Votre premier appel Créez une clé dans Développeurs → Clés API de votre dashboard, puis vérifiez qu'elle fonctionne : ```curl curl 'https://strikespace.net/api/platform/v1/me' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/me', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/me", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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'); } ``` Le guide [Démarrage rapide](https://strikespace.net/developpeurs/demarrage) vous accompagne pas à pas jusqu'à la création de votre premier lead. ## Toute la documentation [Démarrage rapide Créez une clé API et faites vos premiers appels en cinq minutes.](https://strikespace.net/developpeurs/demarrage) [Authentification Clés API, scopes, liste d’IP autorisées, rotation et OAuth 2.1 pour les agents.](https://strikespace.net/developpeurs/authentification) [Conventions de l’API Format, pagination, erreurs, idempotence, limites de débit et versions.](https://strikespace.net/developpeurs/conventions) [Référence de l’API REST Tous les endpoints, la spécification OpenAPI et GET /me.](https://strikespace.net/developpeurs/api) [Leads Lister, rechercher, créer (upsert), modifier et supprimer vos leads.](https://strikespace.net/developpeurs/leads) [Événements Envoyer des événements de tracking depuis votre serveur et consulter l’historique.](https://strikespace.net/developpeurs/evenements) [Segments Lire vos segments, leur définition et les leads qui les composent.](https://strikespace.net/developpeurs/segments) [Tunnels Lire vos tunnels de vente et leurs statistiques.](https://strikespace.net/developpeurs/tunnels) [Flux de relance Lire vos flux de relance et y inscrire des leads.](https://strikespace.net/developpeurs/flux) [Parcours Lire vos parcours comportementaux et y inscrire des leads.](https://strikespace.net/developpeurs/parcours) [Réseaux sociaux Marques, stratégie éditoriale et publications multi-réseaux, avec circuit de validation.](https://strikespace.net/developpeurs/reseaux-sociaux) [Paiements Lire les ventes encaissées par vos tunnels (Mobile Money et carte).](https://strikespace.net/developpeurs/paiements) [Endpoints de webhooks Créer et gérer par l’API les URL qui reçoivent vos événements STRIKE.](https://strikespace.net/developpeurs/webhooks-api) [Webhooks Recevez les événements STRIKE en temps réel, signés et renvoyés en cas d’échec.](https://strikespace.net/developpeurs/webhooks) [Agents IA & MCP Connectez Claude, ChatGPT, Cursor ou VS Code à votre compte STRIKE.](https://strikespace.net/developpeurs/agents-ia) [API de tracking (v1) Événements, identification et création de leads avec la clé publique strk_.](https://strikespace.net/developpeurs/tracking) [SDK JavaScript Le SDK navigateur de 3 Ko : track, identify, page, reset.](https://strikespace.net/developpeurs/sdk-javascript) [Sécurité Comment STRIKE protège vos accès, et les bonnes pratiques de votre côté.](https://strikespace.net/developpeurs/securite) [Changelog Les évolutions de la plateforme développeurs, version par version.](https://strikespace.net/developpeurs/changelog) Sécurité d'abord : clés stockées sous forme de hachage, permissions par scope, jetons OAuth de courte durée, webhooks signés et journal d'audit. Tous les détails sur la page [Sécurité](https://strikespace.net/developpeurs/securite). --- # Démarrage rapide Source : https://strikespace.net/developpeurs/demarrage Créez une clé API et faites vos premiers appels en cinq minutes. En cinq minutes, vous créez une clé API, vérifiez l'accès à votre compte, puis créez et listez vos premiers leads. L'API REST, les webhooks et les agents IA sont inclus dans les offres Pro et Enterprise. Seuls le propriétaire du compte et les administrateurs de l'équipe peuvent créer une clé. ## 1. Créez une clé API - Ouvrez votre dashboard, section Développeurs → Clés API. - Cliquez sur Créer une clé et donnez-lui un nom explicite (par exemple « Back-office production »). - Cochez uniquement les [scopes](https://strikespace.net/developpeurs/authentification#scopes) nécessaires. Pour ce guide : `leads:read` et `leads:write`. - Facultatif : une date d'expiration et une liste d'adresses IP autorisées. - Copiez la clé `sk_live_…` : elle n'est affichée qu'une seule fois. Rangez-la dans une variable d'environnement ou dans votre gestionnaire de secrets : Terminal ```bash # Stockez la clé dans une variable d'environnement, jamais dans le code export STRIKE_API_KEY="sk_live_votre_cle" ``` Une clé `sk_live_` donne accès aux données de votre compte. Ne la placez jamais dans le code d'un site web, d'une application mobile ou d'un dépôt Git. Pour le navigateur, utilisez la [clé de tracking publique](https://strikespace.net/developpeurs/sdk-javascript). ## 2. Vérifiez l'accès avec GET /me Toutes les requêtes s'authentifient avec l'en-tête `Authorization: Bearer `. L'endpoint `/me` retourne votre compte, votre offre, les scopes de la clé et vos limites : ```curl curl 'https://strikespace.net/api/platform/v1/me' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/me', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/me", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 200 ```json { "object": "workspace", "id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "name": "Maison Adjara", "plan": "pro", "scopes": [ "leads:read", "leads:write", "events:write" ], "principal": { "kind": "api_key", "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f", "label": "Back-office", "role": "admin" }, "limits": { "requests_per_minute": 60, "requests_per_day": 50000, "api_keys": 10, "webhook_endpoints": 5, "connected_agents": 20 } } ``` Une réponse `401` signifie que la clé est absente, mal copiée, expirée ou révoquée ; une réponse `403` avec `plan_required` que votre compte n'est pas en offre Pro ou Enterprise. ## 3. Créez votre premier lead `POST /leads` crée le lead, ou met à jour celui qui a déjà cet email ou ce numéro. L'en-tête `Idempotency-Key` vous permet de rejouer la requête sans risque de doublon. ```curl curl -X POST 'https://strikespace.net/api/platform/v1/leads' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "traits": { "source": "crm" } }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/leads', { method: 'POST', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID(), }, body: JSON.stringify({ "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "traits": { "source": "crm" } }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import uuid import requests response = requests.post( "https://strikespace.net/api/platform/v1/leads", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}, json={ "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "traits": { "source": "crm", }, }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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([ 'first_name' => 'Awa', 'email' => 'awa@exemple.com', 'phone_number' => '+22997000000', 'traits' => [ 'source' => 'crm', ], ]), ]); $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'); } ``` La réponse `201` contient le lead avec `"created": true` ; s'il existait déjà, vous recevez `200` et `"created": false`. Le lead apparaît immédiatement dans votre dashboard et reçoit son message de bienvenue. ## 4. Listez vos leads ```curl curl 'https://strikespace.net/api/platform/v1/leads?status=warm&limit=10' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/leads?status=warm&limit=10', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/leads", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, params={ "status": "warm", "limit": 10, }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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'); } ``` Les listes sont paginées par curseur : tant que `has_more` vaut `true`, rappelez l'endpoint avec `cursor=`. Voir [Pagination](https://strikespace.net/developpeurs/conventions#pagination). ## Et ensuite ? - Recevoir les événements : créez un [webhook](https://strikespace.net/developpeurs/webhooks) sur `lead.created` ou `payment.succeeded`. - Envoyer l'activité de vos clients : [POST /events](https://strikespace.net/developpeurs/evenements) depuis votre serveur. - Connecter un assistant IA : suivez le guide [Agents IA & MCP](https://strikespace.net/developpeurs/agents-ia). - Passer en production : relisez les [bonnes pratiques de sécurité](https://strikespace.net/developpeurs/securite#bonnes-pratiques) et la gestion des [limites de débit](https://strikespace.net/developpeurs/conventions#limites). --- # Authentification Source : https://strikespace.net/developpeurs/authentification Clés API, scopes, liste d’IP autorisées, rotation et OAuth 2.1 pour les agents. STRIKE accepte deux types d'identifiants, toujours envoyés dans l'en-tête `Authorization: Bearer` : les clés API, pour vos serveurs et scripts, et les jetons OAuth 2.1, délivrés aux agents IA après votre consentement. ## L'en-tête Authorization HTTP ```http GET /api/platform/v1/me HTTP/1.1 Host: strikespace.net Authorization: Bearer sk_live_votre_cle Accept: application/json ``` Préfixe Type Usage `sk_live_` Clé API secrète Vos serveurs, scripts, outils d'automatisation, CI. Créée dans le dashboard. `stk_at_` Jeton d'accès OAuth Agents IA connectés (Claude, ChatGPT…). Valable 1 heure. `stk_rt_` Jeton de renouvellement OAuth Échangé contre un nouveau jeton d'accès. Valable 30 jours, à usage unique. `strk_` Clé de tracking publique Uniquement l'[API de tracking v1](https://strikespace.net/developpeurs/tracking) (en-tête `X-Strike-Key`). Ne donne accès à aucune donnée. ## Clés API Les clés se gèrent dans Développeurs → Clés API. Seuls le propriétaire du compte et les administrateurs de l'équipe peuvent en créer ou en révoquer ; une clé agit avec les droits d'un administrateur, dans la limite de ses scopes. - Format : `sk_live_` suivi de 32 caractères aléatoires (≈ 190 bits d'entropie). Le dashboard n'affiche ensuite que le début et les 4 derniers caractères (`sk_live_AbCd…wxyz`). - Affichée une seule fois : STRIKE ne conserve qu'une empreinte HMAC-SHA256 de la clé. Une clé perdue ne peut pas être récupérée : créez-en une nouvelle. - Expiration facultative : passé cette date, la clé est refusée (`401`). - Liste d'IP autorisées facultative : adresses exactes (IPv4 ou IPv6) ou plages IPv4 en notation CIDR (`203.0.113.0/24`). Un appel depuis une autre adresse reçoit `403` avec `code: "ip_not_allowed"`. - Suivi : la date et l'adresse IP de dernière utilisation s'affichent à côté de chaque clé ; le détail des appels est dans Développeurs → Journal (30 jours). - Nombre de clés actives : 10 en Pro, 50 en Enterprise. ### Rotation d'une clé Pour remplacer une clé sans interruption de service : - Créez une nouvelle clé avec les mêmes scopes. - Déployez-la dans votre gestionnaire de secrets et redémarrez vos services. - Vérifiez dans le dashboard que l'ancienne clé n'est plus utilisée (date de dernière utilisation). - Révoquez l'ancienne clé. La révocation est immédiate et définitive. Nous recommandons une rotation au moins tous les 90 jours, et immédiatement si une clé a pu être exposée (dépôt Git, capture d'écran, départ d'un prestataire). ## Scopes Chaque clé et chaque agent ne peut faire que ce que ses scopes autorisent. Un appel hors scope reçoit `403` avec `code: "insufficient_scope"`. Les actions d'écriture et d'envoi ont leur propre scope : une intégration en lecture seule ne peut jamais rien modifier. Scope Autorise `leads:read` Lire les leads `leads:write` Créer, modifier et supprimer des leads `events:read` Lire les événements de tracking `events:write` Envoyer des événements de tracking `segments:read` Lire les segments et leurs membres `funnels:read` Lire les tunnels et leurs statistiques `campaigns:read` Lire les flux de relance `campaigns:write` sensible Inscrire des leads dans un flux (envoi de messages) `journeys:read` Lire les parcours `journeys:write` Inscrire des leads dans un parcours `social:read` Lire les marques, publications et stratégies `social:write` Créer et modifier des publications (brouillons, validation) `social:publish` sensible Planifier et publier sur les réseaux sociaux `payments:read` Lire les paiements des tunnels `webhooks:manage` sensible Gérer les webhooks Les scopes sensibles (`campaigns:write`, `social:publish`, `webhooks:manage`) envoient des messages, publient ou reconfigurent votre compte : ils ne sont jamais cochés par défaut. Sans `social:publish`, une publication créée par l'API reste un brouillon ou part en validation auprès de votre équipe. ## OAuth 2.1 pour les agents IA Les clients MCP (Claude, ChatGPT, Cursor, VS Code…) se connectent sans clé : ils s'enregistrent automatiquement, vous redirigent vers une page de consentement STRIKE, puis reçoivent des jetons de courte durée. Si vous utilisez un client du marché, tout est automatique : cette section intéresse ceux qui développent leur propre client. Métadonnées du serveur d'autorisation (RFC 8414) `https://strikespace.net/.well-known/oauth-authorization-server` Métadonnées de ressource protégée (RFC 9728) `https://strikespace.net/.well-known/oauth-protected-resource`, et les variantes `/mcp` et `/api/platform/v1` Enregistrement dynamique (RFC 7591) `POST https://strikespace.net/oauth/register` Autorisation `GET https://strikespace.net/oauth/authorize` Jetons `POST https://strikespace.net/oauth/token` Révocation (RFC 7009) `POST https://strikespace.net/oauth/revoke` ### 1. Découverte Un appel sans jeton à `/mcp` ou à l'API répond `401` avec `WWW-Authenticate: Bearer resource_metadata="https://strikespace.net/.well-known/oauth-protected-resource"`. Le client lit ce document, puis celui du serveur d'autorisation : GET /.well-known/oauth-protected-resource ```json { "resource": "https://strikespace.net/mcp", "authorization_servers": [ "https://strikespace.net" ], "scopes_supported": [ "leads:read", "leads:write", "events:read", "events:write", "segments:read", "funnels:read", "campaigns:read", "campaigns:write", "journeys:read", "journeys:write", "social:read", "social:write", "social:publish", "payments:read", "webhooks:manage" ], "bearer_methods_supported": [ "header" ], "resource_name": "STRIKE — serveur MCP", "resource_documentation": "https://strikespace.net/developpeurs" } ``` GET /.well-known/oauth-authorization-server ```json { "issuer": "https://strikespace.net", "authorization_endpoint": "https://strikespace.net/oauth/authorize", "token_endpoint": "https://strikespace.net/oauth/token", "registration_endpoint": "https://strikespace.net/oauth/register", "revocation_endpoint": "https://strikespace.net/oauth/revoke", "scopes_supported": [ "leads:read", "leads:write", "events:read", "events:write", "segments:read", "funnels:read", "campaigns:read", "campaigns:write", "journeys:read", "journeys:write", "social:read", "social:write", "social:publish", "payments:read", "webhooks:manage" ], "response_types_supported": [ "code" ], "response_modes_supported": [ "query" ], "grant_types_supported": [ "authorization_code", "refresh_token" ], "token_endpoint_auth_methods_supported": [ "none", "client_secret_post", "client_secret_basic" ], "revocation_endpoint_auth_methods_supported": [ "none", "client_secret_post", "client_secret_basic" ], "code_challenge_methods_supported": [ "S256" ], "authorization_response_iss_parameter_supported": true, "service_documentation": "https://strikespace.net/developpeurs", "ui_locales_supported": [ "fr" ] } ``` ### 2. Enregistrement du client L'enregistrement dynamique crée des clients publics (`token_endpoint_auth_method: "none"`, PKCE obligatoire). Les URI de redirection doivent être en `https`, une adresse de bouclage `http://localhost`, `http://127.0.0.1` ou `http://[::1]` (tout port), ou un schéma personnalisé d'application native ; 10 au maximum. L'enregistrement est limité à 20 par heure et par adresse IP. curl ```curl curl -X POST 'https://strikespace.net/oauth/register' \ -H "Content-Type: application/json" \ -d '{ "client_name": "Mon agent interne", "redirect_uris": ["http://127.0.0.1:33418/callback"], "grant_types": ["authorization_code", "refresh_token"], "response_types": ["code"], "token_endpoint_auth_method": "none" }' ``` La réponse contient votre `client_id` (`stc_…`). Les clients enregistrés dynamiquement sont signalés comme « application non vérifiée » sur la page de consentement. ### 3. Autorisation avec PKCE Générez un `code_verifier` aléatoire, dérivez `code_challenge = BASE64URL(SHA256(code_verifier))` (méthode `S256`, la seule acceptée), puis redirigez l'utilisateur : HTTP ```http GET /oauth/authorize?response_type=code &client_id=stc_votre_client &redirect_uri=http%3A%2F%2F127.0.0.1%3A33418%2Fcallback &scope=leads%3Aread%20events%3Awrite &state=8c1f0a9e &code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM &code_challenge_method=S256 &resource=https%3A%2F%2Fstrikespace.net%2Fmcp ``` L'utilisateur se connecte à STRIKE si besoin, voit le nom de l'application, le domaine de redirection, le compte concerné et les scopes demandés, et peut décocher ceux qu'il refuse. Seuls les comptes Pro et Enterprise peuvent approuver. STRIKE redirige ensuite vers votre `redirect_uri` (correspondance exacte) avec `code` et le `state` d'origine. Le code est à usage unique et expire après 10 minutes. ### 4. Échange et renouvellement des jetons curl ```curl # Échange du code contre des jetons curl -X POST 'https://strikespace.net/oauth/token' \ -H "Content-Type: application/x-www-form-urlencoded" \ -d grant_type=authorization_code \ -d code=stk_ac_recu_sur_le_callback \ -d redirect_uri=http://127.0.0.1:33418/callback \ -d client_id=stc_votre_client \ -d code_verifier=dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk \ -d resource=https://strikespace.net/mcp # Renouvellement (le refresh token est remplacé à chaque appel) curl -X POST 'https://strikespace.net/oauth/token' \ -H "Content-Type: application/x-www-form-urlencoded" \ -d grant_type=refresh_token \ -d refresh_token=stk_rt_votre_refresh_token \ -d client_id=stc_votre_client ``` Réponse 200 ```json { "access_token": "stk_at_…", "token_type": "Bearer", "expires_in": 3600, "refresh_token": "stk_rt_…", "scope": "leads:read events:write" } ``` - Durées : jeton d'accès 1 heure, jeton de renouvellement 30 jours. - Rotation : chaque renouvellement délivre un nouveau `refresh_token` et invalide le précédent. Réutiliser un refresh token déjà échangé est traité comme un vol : toute la connexion de l'agent est révoquée. - Révocation : `POST /oauth/revoke` avec le refresh token déconnecte l'agent. L'utilisateur peut aussi le déconnecter depuis Développeurs → Agents IA. ### Liaison du jeton à une ressource (RFC 8707) Un jeton n'est valable que pour la ressource pour laquelle il a été émis. Par défaut, c'est le serveur MCP `https://strikespace.net/mcp`. Pour appeler l'API REST avec un jeton OAuth, envoyez `resource=https://strikespace.net/api/platform/v1` à `/oauth/authorize` et à `/oauth/token` ; sinon le jeton est refusé (`401`) sur `/api/platform/v1`. Un agent agit au nom de la personne qui l'a approuvé, avec son rôle dans l'équipe : les publications créées par l'agent d'un membre de l'équipe passent toujours en validation. Si cette personne quitte l'équipe, l'agent perd l'accès. ## Erreurs d'authentification 401 `authentication_error` : en-tête absent, clé ou jeton invalide, expiré, révoqué, ou lié à une autre ressource. 403 `permission_error` avec `code` : `insufficient_scope` (scope manquant), `plan_required` (offre inférieure à Pro), `ip_not_allowed` (IP hors liste). --- # Conventions de l’API Source : https://strikespace.net/developpeurs/conventions Format, pagination, erreurs, idempotence, limites de débit et versions. Toutes les ressources de l'API suivent les mêmes règles : apprenez-les une fois, elles valent pour chaque endpoint. ## URL de base et format URL de base `https://strikespace.net/api/platform/v1` Transport HTTPS uniquement. Corps de requête et de réponse en JSON UTF-8 (`Content-Type: application/json`). Nommage Champs en `snake_case`. Chaque objet porte `"object": ""` et un `id` (UUID). Dates ISO 8601 en UTC, par exemple `2026-10-16T10:05:51.000Z`. En entrée, toute date ISO 8601 avec fuseau est acceptée. Montants Entiers dans l'unité de la devise (FCFA : `15000` = 15 000 FCFA), avec `currency`. Valeurs absentes Les champs sans valeur sont présents avec `null`, jamais omis. Cache Les réponses portent `Cache-Control: no-store`. ## Pagination Les endpoints de liste retournent une enveloppe commune, triée du plus récent au plus ancien : JSON ```json { "object": "list", "data": [ { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "first_name": "Awa" } ], "has_more": true, "next_cursor": "MjAyNi0xMC0xNFQwOToxMjozMS4wMDBafDhmMTRlNDVm" } ``` - `limit` : de 1 à 100 éléments par page, 25 par défaut. - `cursor` : passez la valeur `next_cursor` reçue pour obtenir la page suivante. Le curseur est opaque : ne le construisez pas et ne l'interprétez pas. - La pagination par curseur est stable : un élément créé pendant que vous parcourez la liste ne décale pas les pages suivantes. - Les filtres doivent être identiques d'une page à l'autre. ```node // Parcourt toutes les pages de /leads async function* allLeads() { let cursor = null do { const url = new URL('https://strikespace.net/api/platform/v1/leads') url.searchParams.set('limit', '100') if (cursor) url.searchParams.set('cursor', cursor) const response = await fetch(url, { headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}` }, }) const page = await response.json() if (!response.ok) throw new Error(page.error.message) yield* page.data cursor = page.has_more ? page.next_cursor : null } while (cursor) } for await (const lead of allLeads()) console.log(lead.id) ``` ```python import os import requests def all_leads(): params = {"limit": 100} headers = {"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"} while True: response = requests.get("https://strikespace.net/api/platform/v1/leads", headers=headers, params=params, timeout=10) response.raise_for_status() page = response.json() yield from page["data"] if not page["has_more"]: break params["cursor"] = page["next_cursor"] for lead in all_leads(): print(lead["id"]) ``` ## Erreurs Toute erreur renvoie un code HTTP adapté et le même format JSON : Réponse 403 ```json { "error": { "type": "permission_error", "message": "Cette clé n’a pas la permission « Créer, modifier et supprimer des leads » (scope leads:write).", "code": "insufficient_scope", "request_id": "6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f" } } ``` HTTP `type` Signification et conduite à tenir 400 / 422 `invalid_request` Requête mal formée ou champ invalide ; `param` désigne le champ. Corrigez avant de renvoyer. 401 `authentication_error` Clé ou jeton absent, invalide, expiré ou révoqué. L'en-tête `WWW-Authenticate` indique les métadonnées OAuth. 403 `permission_error` Accès refusé. `code` précise : `insufficient_scope`, `plan_required`, `ip_not_allowed`, ou une règle métier (quota, canal non inclus). 404 `not_found` Ressource inexistante ou appartenant à un autre compte. 409 `conflict` Conflit d'état : version obsolète, doublon, `Idempotency-Key` réutilisée avec un autre corps, limite de l'offre atteinte. 429 `rate_limit` Trop de requêtes (`code: "rate_limited"`). Attendez `Retry-After` secondes. 500 `internal` Erreur de notre côté. Réessayez avec un délai croissant ; si elle persiste, contactez-nous avec le `request_id`. Réponse 422 ```json { "error": { "type": "invalid_request", "message": "Le champ email doit être une adresse email valide.", "param": "email", "request_id": "0b7e2c4a-1d3f-4e5a-9b6c-7d8e9f0a1b2c" } } ``` Les messages (`message`) sont rédigés en français pour être affichés ou journalisés ; basez votre logique sur `type` et `code`, qui sont stables. ## Identifiant de requête Chaque réponse, succès ou erreur, porte un en-tête `X-Request-Id` (repris dans `error.request_id`). Journalisez-le : il permet à notre support de retrouver votre appel dans nos journaux, et il apparaît dans votre Journal développeurs. ## Idempotence Les requêtes `POST` acceptent un en-tête `Idempotency-Key` (255 caractères maximum, par exemple un UUID v4 ou votre identifiant métier). Pendant 24 heures : - la même clé avec le même corps rejoue la réponse enregistrée, sans refaire l'opération, avec l'en-tête `Idempotent-Replayed: true` ; - la même clé avec un corps différent est refusée : `409`, `code: "idempotency_key_reused"` ; - la même clé pendant que la première requête est encore en cours : `409`, `code: "idempotency_request_in_progress"` (réessayez un instant plus tard) ; - une réponse d'erreur n'est pas mémorisée : après correction, un nouvel envoi avec la même clé est exécuté normalement. curl ```curl # Le même appel peut être rejoué sans risque pendant 24 h curl -X POST 'https://strikespace.net/api/platform/v1/leads' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: crm-contact-48213" \ -d '{ "first_name": "Awa", "email": "awa@exemple.com" }' # Second envoi identique : réponse stockée, en-tête « Idempotent-Replayed: true » ``` Utilisez-la systématiquement pour les créations (leads, événements, publications, inscriptions) : en cas de coupure réseau ou de délai dépassé, vous pouvez renvoyer sans risque de doublon. `PATCH` et `DELETE` sont naturellement idempotents. ## Limites de débit Les limites protègent la plateforme et dépendent de votre offre. La limite par minute s'applique à chaque clé ou agent connecté ; la limite journalière à l'ensemble du compte. Limite Pro Enterprise Requêtes par minute, par clé ou agent 60 300 Requêtes par jour, par compte 50 000 500 000 Clés API actives 10 50 Endpoints de webhooks 5 25 Agents IA connectés 20 100 Chaque réponse indique votre consommation de la minute en cours : HTTP ```http HTTP/1.1 200 OK X-Request-Id: 6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f RateLimit-Limit: 60 RateLimit-Remaining: 57 RateLimit-Reset: 42 HTTP/1.1 429 Too Many Requests Retry-After: 18 RateLimit-Remaining: 0 RateLimit-Reset: 18 ``` - `RateLimit-Limit` : requêtes autorisées par minute ; - `RateLimit-Remaining` : requêtes restantes ; - `RateLimit-Reset` : secondes avant la remise à zéro ; - en cas de dépassement : `429` et `Retry-After` (secondes). Renvoyez uniquement les `429` et les `5xx`, avec un délai croissant et un peu d'aléa : ```node // Renvoi avec délai croissant sur 429 et 5xx uniquement async function strikeFetch(url, options = {}, attempt = 0) { const response = await fetch(url, options) const retryable = response.status === 429 || response.status >= 500 if (!retryable || attempt >= 4) return response const retryAfter = Number(response.headers.get('retry-after')) const delay = retryAfter > 0 ? retryAfter * 1000 : Math.min(30_000, 500 * 2 ** attempt) await new Promise((resolve) => setTimeout(resolve, delay + Math.random() * 250)) return strikeFetch(url, options, attempt + 1) } ``` ```python import random import time import requests def strike_request(method, url, attempt=0, **kwargs): response = requests.request(method, url, timeout=10, **kwargs) retryable = response.status_code == 429 or response.status_code >= 500 if not retryable or attempt >= 4: return response retry_after = response.headers.get("Retry-After") delay = int(retry_after) if retry_after and retry_after.isdigit() else min(30, 0.5 * 2 ** attempt) time.sleep(delay + random.random() / 4) return strike_request(method, url, attempt + 1, **kwargs) ``` ## Versions La version actuelle de l'API est `2026-10-01`. Elle figure dans le chemin (`/v1`) et dans le champ `api_version` de chaque événement webhook. - Changements compatibles, sans préavis : nouveaux endpoints, nouveaux champs dans les réponses, nouveaux paramètres facultatifs, nouveaux types d'événements, nouvelles valeurs de `code`. Votre code doit ignorer les champs inconnus. - Changements incompatibles (suppression ou renommage d'un champ, changement de type) : publiés dans une nouvelle version datée, annoncés à l'avance dans le [changelog](https://strikespace.net/developpeurs/changelog) et par email ; l'ancienne version reste disponible pendant une période de transition. --- # Référence de l’API REST Source : https://strikespace.net/developpeurs/api Tous les endpoints, la spécification OpenAPI et GET /me. L'API REST privée donne accès aux données de votre compte STRIKE : leads, événements, segments, tunnels, flux, parcours, réseaux sociaux, paiements et webhooks. Elle est réservée aux offres Pro et Enterprise. ## URL de base et authentification URL de base `https://strikespace.net/api/platform/v1` Authentification `Authorization: Bearer sk_live_…` (ou jeton OAuth) — voir [Authentification](https://strikespace.net/developpeurs/authentification) Format JSON, `snake_case`, pagination par curseur — voir [Conventions](https://strikespace.net/developpeurs/conventions) Version `2026-10-01` ## Spécification OpenAPI La spécification OpenAPI 3.1 décrit chaque endpoint et chaque webhook. Elle est publique (aucune clé requise) : importez-la dans Postman, Insomnia ou Bruno, ou générez un client typé avec `openapi-generator`. [https://strikespace.net/api/platform/v1/openapi.json](https://strikespace.net/api/platform/v1/openapi.json) ```curl curl 'https://strikespace.net/api/platform/v1/openapi.json' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/openapi.json') const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import requests response = requests.get( "https://strikespace.net/api/platform/v1/openapi.json", timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'GET', ]); $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'); } ``` ## Compte et permissions de la clé GET `/api/platform/v1/me` toute clé valide Retourne le compte (workspace) auquel la clé ou le jeton donne accès, l’offre, les scopes accordés, l’identité de l’appelant (clé ou agent, avec son rôle) et les limites de l’offre. Idéal pour vérifier une intégration au démarrage. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/me' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/me', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/me", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "workspace", "id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "name": "Maison Adjara", "plan": "pro", "scopes": [ "leads:read", "leads:write", "events:write" ], "principal": { "kind": "api_key", "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f", "label": "Back-office", "role": "admin" }, "limits": { "requests_per_minute": 60, "requests_per_day": 50000, "api_keys": 10, "webhook_endpoints": 5, "connected_agents": 20 } } ``` ### Erreurs spécifiques 401 Clé absente, invalide, expirée ou révoquée (`authentication_error`). 403 Offre inférieure à Pro (`plan_required`) ou IP non autorisée (`ip_not_allowed`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `get_workspace`. ## Tous les endpoints ### Leads GET [`/leads`](https://strikespace.net/developpeurs/leads#list-leads) Lister les leads `leads:read` GET [`/leads/:id`](https://strikespace.net/developpeurs/leads#get-lead) Récupérer un lead `leads:read` POST [`/leads`](https://strikespace.net/developpeurs/leads#upsert-lead) Créer ou mettre à jour un lead `leads:write` PATCH [`/leads/:id`](https://strikespace.net/developpeurs/leads#update-lead) Modifier un lead `leads:write` DELETE [`/leads/:id`](https://strikespace.net/developpeurs/leads#delete-lead) Supprimer un lead (RGPD) `leads:write` GET [`/leads/:id/events`](https://strikespace.net/developpeurs/leads#lead-events) Événements d’un lead `events:read` ### Événements POST [`/events`](https://strikespace.net/developpeurs/evenements#track-event) Envoyer un événement `events:write` GET [`/events`](https://strikespace.net/developpeurs/evenements#list-events) Lister les événements `events:read` ### Segments GET [`/segments`](https://strikespace.net/developpeurs/segments#list-segments) Lister les segments `segments:read` GET [`/segments/:id`](https://strikespace.net/developpeurs/segments#get-segment) Récupérer un segment `segments:read` GET [`/segments/:id/leads`](https://strikespace.net/developpeurs/segments#segment-leads) Leads d’un segment `segments:read` ### Tunnels GET [`/funnels`](https://strikespace.net/developpeurs/tunnels#list-funnels) Lister les tunnels `funnels:read` GET [`/funnels/:id`](https://strikespace.net/developpeurs/tunnels#get-funnel) Récupérer un tunnel et ses statistiques `funnels:read` ### Flux de relance GET [`/campaigns`](https://strikespace.net/developpeurs/flux#list-campaigns) Lister les flux `campaigns:read` GET [`/campaigns/:id`](https://strikespace.net/developpeurs/flux#get-campaign) Récupérer un flux `campaigns:read` POST [`/campaigns/:id/enrollments`](https://strikespace.net/developpeurs/flux#enroll-campaign) Inscrire un lead dans un flux `campaigns:write` ### Parcours GET [`/journeys`](https://strikespace.net/developpeurs/parcours#list-journeys) Lister les parcours `journeys:read` GET [`/journeys/:id`](https://strikespace.net/developpeurs/parcours#get-journey) Récupérer un parcours `journeys:read` POST [`/journeys/:id/enrollments`](https://strikespace.net/developpeurs/parcours#enroll-journey) Inscrire un lead dans un parcours `journeys:write` ### Réseaux sociaux GET [`/brands`](https://strikespace.net/developpeurs/reseaux-sociaux#list-brands) Lister les marques `social:read` GET [`/brands/:id`](https://strikespace.net/developpeurs/reseaux-sociaux#get-brand) Récupérer une marque `social:read` GET [`/brands/:id/strategy`](https://strikespace.net/developpeurs/reseaux-sociaux#get-brand-strategy) Stratégie éditoriale d’une marque `social:read` GET [`/social/posts`](https://strikespace.net/developpeurs/reseaux-sociaux#list-posts) Lister les publications `social:read` GET [`/social/posts/:id`](https://strikespace.net/developpeurs/reseaux-sociaux#get-post) Récupérer une publication `social:read` POST [`/social/posts`](https://strikespace.net/developpeurs/reseaux-sociaux#create-post) Créer une publication `social:write` PATCH [`/social/posts/:id`](https://strikespace.net/developpeurs/reseaux-sociaux#update-post) Modifier une publication `social:write` POST [`/social/posts/:id/submit`](https://strikespace.net/developpeurs/reseaux-sociaux#submit-post) Envoyer en validation `social:write` POST [`/social/posts/:id/schedule`](https://strikespace.net/developpeurs/reseaux-sociaux#schedule-post) Planifier une publication `social:publish` POST [`/social/posts/:id/publish`](https://strikespace.net/developpeurs/reseaux-sociaux#publish-post) Publier immédiatement `social:publish` DELETE [`/social/posts/:id`](https://strikespace.net/developpeurs/reseaux-sociaux#delete-post) Supprimer un brouillon `social:write` ### Paiements GET [`/payments`](https://strikespace.net/developpeurs/paiements#list-payments) Lister les paiements `payments:read` ### Endpoints de webhooks GET [`/webhook_endpoints`](https://strikespace.net/developpeurs/webhooks-api#list-webhook-endpoints) Lister les endpoints `webhooks:manage` POST [`/webhook_endpoints`](https://strikespace.net/developpeurs/webhooks-api#create-webhook-endpoint) Créer un endpoint `webhooks:manage` GET [`/webhook_endpoints/:id`](https://strikespace.net/developpeurs/webhooks-api#get-webhook-endpoint) Récupérer un endpoint `webhooks:manage` PATCH [`/webhook_endpoints/:id`](https://strikespace.net/developpeurs/webhooks-api#update-webhook-endpoint) Modifier un endpoint `webhooks:manage` DELETE [`/webhook_endpoints/:id`](https://strikespace.net/developpeurs/webhooks-api#delete-webhook-endpoint) Supprimer un endpoint `webhooks:manage` POST [`/webhook_endpoints/:id/rotate_secret`](https://strikespace.net/developpeurs/webhooks-api#rotate-webhook-secret) Renouveler le secret `webhooks:manage` POST [`/webhook_endpoints/:id/test`](https://strikespace.net/developpeurs/webhooks-api#test-webhook-endpoint) Envoyer un événement de test `webhooks:manage` GET [`/webhook_endpoints/:id/deliveries`](https://strikespace.net/developpeurs/webhooks-api#list-webhook-deliveries) Historique des livraisons `webhooks:manage` POST [`/webhook_deliveries/:id/retry`](https://strikespace.net/developpeurs/webhooks-api#retry-webhook-delivery) Renvoyer une livraison `webhooks:manage` --- # Leads Source : https://strikespace.net/developpeurs/leads Lister, rechercher, créer (upsert), modifier et supprimer vos leads. Un lead est un contact capté par vos tunnels, votre site ou votre propre code. Il porte ses coordonnées, son canal de relance préféré, son statut commercial et des traits libres que vous pouvez utiliser dans vos segments. GET `/leads` Lister les leads GET `/leads/:id` Récupérer un lead POST `/leads` Créer ou mettre à jour un lead PATCH `/leads/:id` Modifier un lead DELETE `/leads/:id` Supprimer un lead (RGPD) GET `/leads/:id/events` Événements d’un lead ## L'objet lead Champ Type Description `id` uuid Identifiant STRIKE du lead. `first_name` string Prénom. `email` string | null Adresse email, en minuscules. `phone_number` string | null Numéro au format international (`+229…`). `country_code` string Code pays ISO à 2 lettres. `preferred_channel` string `whatsapp`, `email` ou `sms`. `status` string `cold`, `warm`, `converted` ou `blacklisted`. `funnel_id` uuid | null Tunnel qui a capté le lead. `traits` object Attributs libres (plan, ville, source…). `unsubscribed` boolean Vrai si le lead s’est désinscrit des relances. `unsubscribed_at` datetime | null Date de désinscription des relances. `created_at` datetime Date de création (ISO 8601, UTC). `updated_at` datetime | null Dernière modification. ## Lister les leads GET `/api/platform/v1/leads` leads:read Retourne les leads du compte, du plus récent au plus ancien. Tous les filtres sont combinables. ### Paramètres de requête Champ Type Description `status` string `cold`, `warm`, `converted` ou `blacklisted`. `email` string Correspondance exacte (insensible à la casse). `phone_number` string Correspondance exacte, format international. `funnel_id` uuid Leads captés par ce tunnel. `created_after` datetime Créés à partir de cette date (ISO 8601). `created_before` datetime Créés avant cette date (ISO 8601). `q` string Recherche plein texte sur le prénom, l’email et le téléphone. `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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/leads?status=warm&limit=10' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/leads?status=warm&limit=10', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/leads", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, params={ "status": "warm", "limit": 10, }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "status": "warm", "funnel_id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", "traits": { "plan": "pro", "city": "Cotonou" }, "unsubscribed": false, "unsubscribed_at": null, "created_at": "2026-10-14T09:12:31.000Z", "updated_at": "2026-10-15T16:02:11.000Z" } ], "has_more": true, "next_cursor": "MjAyNi0xMC0xNFQwOToxMjozMS4wMDBafDhmMTRlNDVm" } ``` ### 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](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `search_leads`. ## Récupérer un lead GET `/api/platform/v1/leads/:id` leads:read Retourne un lead par son identifiant. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du lead. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "status": "warm", "funnel_id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", "traits": { "plan": "pro", "city": "Cotonou" }, "unsubscribed": false, "unsubscribed_at": null, "created_at": "2026-10-14T09:12:31.000Z", "updated_at": "2026-10-15T16:02:11.000Z" } ``` ### Erreurs spécifiques 404 Lead introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `get_lead`. ## Créer ou mettre à jour un lead POST `/api/platform/v1/leads` leads:write Crée un lead, ou met à jour le lead existant qui a le même email ou le même numéro (upsert). Un nouveau lead répond `201` avec `"created": true` ; un lead existant répond `200` avec `"created": false`. Sur un lead existant, le prénom, le pays, le canal et le statut envoyés sont mis à jour, l’email et le téléphone ne sont complétés que s’ils étaient vides, et les traits sont fusionnés. Un lead créé entre dans votre quota mensuel. Émet `lead.created` ou `lead.updated`. ### Corps de la requête (JSON) Champ Type Description `email` string Email valide. `email` ou `phone_number` est requis. `phone_number` string Format international E.164, par exemple `+22997000000`. `first_name` string Prénom, 1 à 100 caractères. Par défaut, la partie de l’email avant « @ ». `country_code` string Code ISO à 2 lettres. Par défaut `BJ`. `preferred_channel` string `whatsapp`, `email` ou `sms`, inclus dans votre offre. Par défaut : email si le lead n’a qu’un email, sinon le canal habituel du pays. `status` string `cold` (défaut), `warm`, `converted` ou `blacklisted`. `funnel_id` uuid Tunnel d’origine (doit appartenir à votre compte). `traits` object Attributs libres, fusionnés avec les traits existants (16 Ko max.). ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/leads' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "traits": { "plan": "pro", "city": "Cotonou" } }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/leads', { method: 'POST', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID(), }, body: JSON.stringify({ "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "traits": { "plan": "pro", "city": "Cotonou" } }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import uuid import requests response = requests.post( "https://strikespace.net/api/platform/v1/leads", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}, json={ "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "traits": { "plan": "pro", "city": "Cotonou", }, }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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([ 'first_name' => 'Awa', 'email' => 'awa@exemple.com', 'phone_number' => '+22997000000', 'country_code' => 'BJ', 'preferred_channel' => 'whatsapp', 'traits' => [ 'plan' => 'pro', 'city' => 'Cotonou', ], ]), ]); $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 ```json { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "status": "cold", "funnel_id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", "traits": { "plan": "pro", "city": "Cotonou" }, "unsubscribed": false, "unsubscribed_at": null, "created_at": "2026-10-14T09:12:31.000Z", "updated_at": "2026-10-15T16:02:11.000Z", "created": true } ``` ### Erreurs spécifiques 422 Paramètre invalide (`invalid_request`) ; `param` indique le champ en cause. 403 Quota mensuel de leads atteint (`quota_exceeded`) ou canal non inclus dans votre offre (`permission_error`). 404 Tunnel (`funnel_id`) introuvable, ou appartenant à un autre compte (`not_found`). 409 `Idempotency-Key` réutilisée avec un autre corps (`idempotency_key_reused`) ou requête identique encore en cours (`idempotency_request_in_progress`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `upsert_lead`. ## Modifier un lead PATCH `/api/platform/v1/leads/:id` leads:write Modifie uniquement les champs envoyés. `traits` est fusionné au premier niveau : une clé envoyée remplace la valeur existante (y compris par `null`), les autres clés sont conservées. Un lead doit garder au moins un email ou un téléphone. Émet `lead.updated`, et `lead.converted` au passage à `converted`. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du lead. ### Corps de la requête (JSON) Champ Type Description `first_name` string Prénom. `email` string | null Email. `phone_number` string | null Téléphone, format international. `country_code` string Code ISO à 2 lettres. `preferred_channel` string `whatsapp`, `email` ou `sms`. `status` string `cold`, `warm`, `converted` ou `blacklisted`. Passer à `converted` émet `lead.converted`. `traits` object Fusion superficielle avec les traits existants. ### Exemple de requête ```curl curl -X PATCH 'https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "status": "converted", "traits": { "last_order": "CMD-1042" } }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80', { method: 'PATCH', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "status": "converted", "traits": { "last_order": "CMD-1042" } }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import requests response = requests.patch( "https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, json={ "status": "converted", "traits": { "last_order": "CMD-1042", }, }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('STRIKE_API_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'status' => 'converted', 'traits' => [ 'last_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 200 ```json { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "status": "converted", "funnel_id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", "traits": { "plan": "pro", "city": "Cotonou", "last_order": "CMD-1042" }, "unsubscribed": false, "unsubscribed_at": null, "created_at": "2026-10-14T09:12:31.000Z", "updated_at": "2026-10-15T16:02:11.000Z" } ``` ### Erreurs spécifiques 404 Lead introuvable, ou appartenant à un autre compte (`not_found`). 422 Paramètre invalide (`invalid_request`) ; `param` indique le champ en cause. 409 Email ou téléphone déjà utilisé par un autre lead (`conflict`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `update_lead`. ## Supprimer un lead (RGPD) DELETE `/api/platform/v1/leads/:id` leads:write Efface définitivement le lead et ses données personnelles (droit à l’effacement). Ses inscriptions en cours sont arrêtées. Cette action est irréversible et émet `lead.deleted`. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du lead. ### Exemple de requête ```curl curl -X DELETE 'https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80', { method: 'DELETE', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, }, }) if (!response.ok) throw new Error((await response.json()).error.message) ``` ```python import os import requests response = requests.delete( "https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() ``` ```php true, CURLOPT_CUSTOMREQUEST => 'DELETE', 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 ```json { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "deleted": true } ``` ### Erreurs spécifiques 404 Lead introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Événements d’un lead GET `/api/platform/v1/leads/:id/events` events:read Historique des événements de tracking rattachés au lead, du plus récent au plus ancien. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du lead. ### Paramètres de requête Champ Type Description `name` string Filtre sur le nom de l’événement. `since` datetime Survenus à 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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80/events?limit=20' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80/events?limit=20', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/leads/8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80/events", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, params={ "limit": 20, }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "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 404 Lead introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). --- # Événements Source : https://strikespace.net/developpeurs/evenements 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](https://strikespace.net/developpeurs/tracking) : il utilise le même pipeline d’ingestion. POST `/events` Envoyer un événement GET `/events` Lister les événements ## 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 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 // 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) ``` ```python 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 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 ```json { "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](https://strikespace.net/developpeurs/conventions#erreurs). É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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/events?name=checkout_started&since=2026-10-01T00%3A00%3A00Z' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // 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) ``` ```python 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 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 ```json { "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](https://strikespace.net/developpeurs/conventions#erreurs). --- # Segments Source : https://strikespace.net/developpeurs/segments Lire vos segments, leur définition et les leads qui les composent. Un segment regroupe les leads qui remplissent des conditions sur leurs événements et leurs attributs. Les segments se créent dans Engagement → Segments ; l’API permet de les lire et d’en extraire les membres, par exemple pour synchroniser une audience publicitaire ou votre CRM. GET `/segments` Lister les segments GET `/segments/:id` Récupérer un segment GET `/segments/:id/leads` Leads d’un segment ## L'objet segment Champ Type Description `id` uuid Identifiant du segment. `name` string Nom. `description` string | null Description. `definition` object Conditions du segment (format décrit plus bas). `lead_count` integer Uniquement sur `GET /segments/:id` : nombre de leads calculé au moment de l’appel. `created_at` datetime Date de création. `updated_at` datetime | null Dernière modification. ## Lister les segments GET `/api/platform/v1/segments` segments:read Retourne les segments du compte. ### Paramètres de requête Champ Type Description `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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/segments' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/segments', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/segments", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "segment", "id": "a87ff679-a2f3-4e71-9181-0c7e4b2d5f63", "name": "Paniers abandonnés (30 j)", "description": "Ont commencé un paiement sans le terminer ce mois-ci.", "definition": { "match": "all", "conditions": [ { "type": "event", "event": "checkout_started", "timeframe": "last_30_days" }, { "type": "event", "event": "order_paid", "count": "= 0", "timeframe": "last_30_days" } ] }, "created_at": "2026-09-02T10:00:00.000Z", "updated_at": "2026-10-01T08:30:00.000Z" } ], "has_more": false, "next_cursor": null } ``` Équivalent pour les agents IA : l'outil MCP `list_segments`. ## Récupérer un segment GET `/api/platform/v1/segments/:id` segments:read Retourne un segment, sa définition et son nombre de leads actuel. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du segment. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/segments/a87ff679-a2f3-4e71-9181-0c7e4b2d5f63' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/segments/a87ff679-a2f3-4e71-9181-0c7e4b2d5f63', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/segments/a87ff679-a2f3-4e71-9181-0c7e4b2d5f63", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "segment", "id": "a87ff679-a2f3-4e71-9181-0c7e4b2d5f63", "name": "Paniers abandonnés (30 j)", "description": "Ont commencé un paiement sans le terminer ce mois-ci.", "definition": { "match": "all", "conditions": [ { "type": "event", "event": "checkout_started", "timeframe": "last_30_days" }, { "type": "event", "event": "order_paid", "count": "= 0", "timeframe": "last_30_days" } ] }, "created_at": "2026-09-02T10:00:00.000Z", "updated_at": "2026-10-01T08:30:00.000Z", "lead_count": 128 } ``` ### Erreurs spécifiques 404 Segment introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Leads d’un segment GET `/api/platform/v1/segments/:id/leads` segments:read Évalue le segment au moment de l’appel et retourne les leads qui en font partie. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du segment. ### Paramètres de requête Champ Type Description `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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/segments/a87ff679-a2f3-4e71-9181-0c7e4b2d5f63/leads?limit=100' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/segments/a87ff679-a2f3-4e71-9181-0c7e4b2d5f63/leads?limit=100', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/segments/a87ff679-a2f3-4e71-9181-0c7e4b2d5f63/leads", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, params={ "limit": 100, }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "status": "warm", "funnel_id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", "traits": { "plan": "pro", "city": "Cotonou" }, "unsubscribed": false, "unsubscribed_at": null, "created_at": "2026-10-14T09:12:31.000Z", "updated_at": "2026-10-15T16:02:11.000Z" } ], "has_more": true, "next_cursor": "MjAyNi0xMC0xNFQwOToxMjozMS4wMDBafDhmMTRlNDVm" } ``` ### Erreurs spécifiques 404 Segment introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `get_segment_leads`. ## Format de définition d'un segment Le champ `definition` est un document JSON. Vous le construisez visuellement dans Engagement → Segments, avec un aperçu des leads concernés ; il peut ensuite déclencher un parcours ou servir de condition dans le Journey Builder. JSON · « connecté plus de 2 fois cette semaine, offre Pro, jamais passé commande » ```json { "match": "all", "conditions": [ { "type": "event", "event": "login", "count": "> 2", "timeframe": "last_7_days" }, { "type": "attribute", "field": "traits.plan", "operator": "eq", "value": "pro" }, { "type": "event", "event": "checkout", "count": "= 0" } ] } ``` ### Conditions sur un événement Clé Valeurs `event` Nom de l'événement, tel qu'envoyé à `track` ou `POST /events`. `count` `>`, `>=`, `<`, `<=`, `=`, `!=` suivi d'un nombre. Par défaut `>= 1`. `= 0` inclut les leads qui n'ont jamais fait l'action. `timeframe` `last__minutes|hours|days|weeks|months`, `all_time` (défaut) ou une plage `{ "from": "…", "to": "…" }` en dates ISO. `where` Filtres sur les propriétés : `{ "property": "cart.total", "operator": "gte", "value": 20000 }`. ### Conditions sur un attribut `field` désigne une colonne du lead (`first_name`, `email`, `phone_number`, `country_code`, `status`, `preferred_channel`, `funnel_id`, `created_at`) ou un trait (`traits.`). Opérateurs disponibles (attributs et filtres `where`) : `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `contains` (texte, insensible à la casse), `in` (liste de valeurs), `exists`, `not_exists`. ### Groupes imbriqués Combinez `"match": "all"` (ET) et `"match": "any"` (OU) avec des conditions de type `group`, jusqu'à 4 niveaux et 50 conditions par segment. JSON · « a abandonné son panier ce mois-ci, à Cotonou ou Abidjan » ```json { "match": "all", "conditions": [ { "type": "event", "event": "checkout_started", "timeframe": "last_30_days", "where": [{ "property": "cart_total", "operator": "gte", "value": 20000 }] }, { "type": "event", "event": "order_paid", "count": "= 0", "timeframe": "last_30_days" }, { "type": "group", "match": "any", "conditions": [ { "type": "attribute", "field": "traits.city", "operator": "in", "value": ["Cotonou", "Abidjan"] }, { "type": "attribute", "field": "country_code", "operator": "eq", "value": "CI" } ] } ] } ``` --- # Tunnels Source : https://strikespace.net/developpeurs/tunnels Lire vos tunnels de vente et leurs statistiques. Les tunnels sont vos pages de capture hébergées par STRIKE. L’API donne accès à leur configuration et à leurs performances pour vos tableaux de bord internes. GET `/funnels` Lister les tunnels GET `/funnels/:id` Récupérer un tunnel et ses statistiques ## L'objet funnel Champ Type Description `id` uuid Identifiant du tunnel. `name` string Nom interne. `slug` string Segment d’URL de la page publique. `status` string `draft`, `published` ou `paused`. `template` string Modèle de page : `minimal`, `showcase` ou `urgency`. `url` string URL publique de la page. `product_name` string | null Produit vendu. `product_price` integer | null Prix, dans la devise `currency` (FCFA). `campaign_id` uuid | null Flux de relance associé. `stats` object Uniquement sur `GET /funnels/:id` : `leads`, `converted_leads`, `conversion_rate` (0 à 1), `payments_succeeded`, `revenue`, `currency`. ## Lister les tunnels GET `/api/platform/v1/funnels` funnels:read Retourne les tunnels du compte. ### Paramètres de requête Champ Type Description `status` string `draft`, `published` 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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/funnels?status=published' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/funnels?status=published', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/funnels", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, params={ "status": "published", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "funnel", "id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", "name": "Collection d’été", "slug": "collection-ete", "status": "published", "template": "showcase", "url": "https://strikespace.net/f/collection-ete", "headline": "La collection d’été est arrivée", "product_name": "Robe wax", "product_price": 15000, "currency": "XOF", "campaign_id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54", "created_at": "2026-08-20T12:00:00.000Z", "updated_at": "2026-10-10T09:00:00.000Z" } ], "has_more": false, "next_cursor": null } ``` Équivalent pour les agents IA : l'outil MCP `list_funnels`. ## Récupérer un tunnel et ses statistiques GET `/api/platform/v1/funnels/:id` funnels:read Retourne le tunnel avec ses statistiques cumulées. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du tunnel. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/funnels/3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/funnels/3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/funnels/3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "funnel", "id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", "name": "Collection d’été", "slug": "collection-ete", "status": "published", "template": "showcase", "url": "https://strikespace.net/f/collection-ete", "headline": "La collection d’été est arrivée", "product_name": "Robe wax", "product_price": 15000, "currency": "XOF", "campaign_id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54", "created_at": "2026-08-20T12:00:00.000Z", "updated_at": "2026-10-10T09:00:00.000Z", "stats": { "leads": 412, "converted_leads": 37, "conversion_rate": 0.0898, "payments_succeeded": 37, "revenue": 555000, "currency": "XOF" } } ``` ### Erreurs spécifiques 404 Tunnel introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `get_funnel`. --- # Flux de relance Source : https://strikespace.net/developpeurs/flux Lire vos flux de relance et y inscrire des leads. Un flux (ou campagne) est une séquence de messages WhatsApp, email ou SMS envoyée automatiquement à un lead. Inscrire un lead par l’API déclenche de vrais envois : c’est pourquoi le scope `campaigns:write` n’est jamais accordé par défaut. GET `/campaigns` Lister les flux GET `/campaigns/:id` Récupérer un flux POST `/campaigns/:id/enrollments` Inscrire un lead dans un flux ## L'objet campaign Champ Type Description `id` uuid Identifiant du flux. `name` string Nom. `flow_type` string `direct_response`, `click_to_chat`, `lead_magnet`, `webinar` ou `outbound_b2b`. `status` string `draft`, `active` ou `paused`. `steps` array Étapes dans l’ordre : `order`, `channel`, `delay_minutes`, `content_template`. `created_at` datetime Date de création. ## Lister les flux GET `/api/platform/v1/campaigns` campaigns:read Retourne les flux du compte avec leurs étapes. ### 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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/campaigns' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/campaigns', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/campaigns", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "campaign", "id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54", "name": "Relance Collection d’été", "flow_type": "direct_response", "status": "active", "steps": [ { "id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b", "order": 1, "channel": "whatsapp", "delay_minutes": 0, "content_template": "Bonjour {{first_name}}, merci pour votre intérêt !" } ], "created_at": "2026-08-20T12:05:00.000Z", "updated_at": "2026-09-30T18:00:00.000Z" } ], "has_more": false, "next_cursor": null } ``` Équivalent pour les agents IA : l'outil MCP `list_campaigns`. ## Récupérer un flux GET `/api/platform/v1/campaigns/:id` campaigns:read Retourne un flux et ses étapes. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du flux. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "campaign", "id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54", "name": "Relance Collection d’été", "flow_type": "direct_response", "status": "active", "steps": [ { "id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b", "order": 1, "channel": "whatsapp", "delay_minutes": 0, "content_template": "Bonjour {{first_name}}, merci pour votre intérêt !" } ], "created_at": "2026-08-20T12:05:00.000Z", "updated_at": "2026-09-30T18:00:00.000Z" } ``` ### Erreurs spécifiques 404 Flux introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Inscrire un lead dans un flux POST `/api/platform/v1/campaigns/:id/enrollments` campaigns:write Démarre le flux pour ce lead : la première étape est planifiée (`first_step_at`) et les messages partent ensuite automatiquement. Les mêmes règles que dans le dashboard s’appliquent : flux actif et non vide, type de flux et canaux inclus dans votre offre, lead non désinscrit ni bloqué, coordonnée disponible pour le canal de la première étape. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant du flux. ### Corps de la requête (JSON) Champ Type Description `lead_id` requis uuid Lead de votre compte à inscrire. ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/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 // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/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) ``` ```python import os import uuid import requests response = requests.post( "https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/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 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 ```json { "object": "campaign_enrollment", "campaign_id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54", "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "status": "scheduled", "first_step_at": "2026-10-16T10:20:00.000Z" } ``` ### Erreurs spécifiques 404 Flux ou lead introuvable, ou appartenant à un autre compte (`not_found`). 403 Type de flux (`plan_required`) ou canal (`channel_not_in_plan`) non inclus dans votre offre. 409 Flux inactif (`campaign_inactive`) ou sans étape (`campaign_empty`), lead désinscrit ou bloqué (`lead_opted_out`). 422 Le lead n’a pas d’email ou de téléphone pour le canal de la première étape. Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `enroll_in_campaign`. --- # Parcours Source : https://strikespace.net/developpeurs/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. GET `/journeys` Lister les parcours GET `/journeys/:id` Récupérer un parcours POST `/journeys/:id/enrollments` Inscrire un lead dans un parcours ## 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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/journeys' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // 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) ``` ```python 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 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 ```json { "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 curl 'https://strikespace.net/api/platform/v1/journeys/1679091c-5a88-4faf-9b4c-2d7e8f3a6b15' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // 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) ``` ```python 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 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 ```json { "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](https://strikespace.net/developpeurs/conventions#erreurs). ## 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 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 // 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) ``` ```python 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 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 ```json { "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](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `enroll_in_journey`. --- # Réseaux sociaux Source : https://strikespace.net/developpeurs/reseaux-sociaux Marques, stratégie éditoriale et publications multi-réseaux, avec circuit de validation. Publiez sur Facebook, Instagram, TikTok, LinkedIn et X à partir de vos marques STRIKE. Une publication part d’un brouillon, peut passer par la validation de votre équipe, puis est planifiée et publiée automatiquement à l’heure prévue. GET `/brands` Lister les marques GET `/brands/:id` Récupérer une marque GET `/brands/:id/strategy` Stratégie éditoriale d’une marque GET `/social/posts` Lister les publications GET `/social/posts/:id` Récupérer une publication POST `/social/posts` Créer une publication PATCH `/social/posts/:id` Modifier une publication POST `/social/posts/:id/submit` Envoyer en validation POST `/social/posts/:id/schedule` Planifier une publication POST `/social/posts/:id/publish` Publier immédiatement DELETE `/social/posts/:id` Supprimer un brouillon ## L'objet social_post Champ Type Description `id` uuid Identifiant de la publication. `brand_id` uuid Marque. `status` string `draft`, `pending_approval`, `approved`, `scheduled`, `publishing`, `published`, `partially_published`, `failed` ou `canceled`. `title` string | null Titre interne. `body` string Texte commun à tous les réseaux. `media` array Médias : `{ url, type: "image" | "video", alt? }`. `link_url` string | null Lien joint à la publication. `overrides` object Texte spécifique par réseau : `{ "instagram": { "body": "…" } }`. `pillar` string | null Pilier éditorial de la stratégie. `scheduled_at` datetime | null Publication prévue. `published_at` datetime | null Publication effective. `version` integer Version, pour la modification concurrente (`base_version`). `approved_at` datetime | null Date d’approbation (`approved_by` : qui a approuvé). `author_id` uuid | null Auteur (personne derrière la clé ou l’agent). `rejected_reason` string | null Motif d’un refus en validation. `targets` array Un élément par compte : `account_id`, `provider`, `status` (`pending`, `publishing`, `published`, `failed`, `skipped`), `permalink`, `external_post_id`, `error`, `published_at`. ## Cycle de vie d'une publication Le circuit est le même que dans le dashboard ; ce que l'API peut faire dépend de vos scopes et, pour un agent IA, du rôle de la personne qui l'a connecté. - Brouillon (`draft`) : créé avec `action: "draft"` (par défaut). Modifiable librement. - En validation (`pending_approval`) : avec `action: "submit"` ou `POST /social/posts/:id/submit`. Les validateurs de votre équipe sont notifiés et approuvent depuis le dashboard. - Planifiée (`scheduled`) : avec le scope `social:publish`, `action: "schedule"` ou `POST /social/posts/:id/schedule` ; `POST /social/posts/:id/publish` publie immédiatement. - Publiée (`published`, ou `partially_published` si un réseau a échoué), ou en échec (`failed`) : à l'heure prévue, STRIKE publie sur chaque compte ciblé ; le détail est dans `targets`. Sans le scope `social:publish`, rien n'est publié sans validation humaine : une demande de planification devient une demande de validation (`pending_approval`), signalée par le champ `notice` de la réponse. Les publications d'un agent connecté par un membre de l'équipe (non administrateur) passent toujours en validation. Les quotas de publications de votre offre s'appliquent (60 posts par marque et par mois en Starter, 300 en Pro, illimité en Enterprise). Les médias doivent être accessibles publiquement en HTTPS ; chaque réseau applique ses propres limites de taille et de format. ## Lister les marques GET `/api/platform/v1/brands` social:read Retourne les marques et leurs comptes sociaux connectés (jamais leurs jetons). ### Paramètres de requête Champ Type Description `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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/brands' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/brands', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/brands", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "brand", "id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "name": "Maison Adjara", "slug": "maison-adjara", "logo_url": null, "timezone": "Africa/Porto-Novo", "language": "fr", "industry": "Mode", "website": "https://maison-adjara.example", "description": "Prêt-à-porter en wax, fabriqué à Cotonou.", "tone": "Chaleureux et fier", "audience": "Femmes actives 25-40 ans", "hashtags": [ "#wax", "#madeinbenin" ], "accounts": [ { "object": "social_account", "id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "display_name": "Maison Adjara", "username": null, "status": "connected" }, { "object": "social_account", "id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "display_name": "Maison Adjara", "username": "maisonadjara", "status": "connected" } ], "created_at": "2026-09-01T09:00:00.000Z", "updated_at": "2026-10-02T11:00:00.000Z" } ], "has_more": false, "next_cursor": null } ``` Équivalent pour les agents IA : l'outil MCP `list_brands`. ## Récupérer une marque GET `/api/platform/v1/brands/:id` social:read Retourne une marque, son ton et ses comptes connectés. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la marque. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "brand", "id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "name": "Maison Adjara", "slug": "maison-adjara", "logo_url": null, "timezone": "Africa/Porto-Novo", "language": "fr", "industry": "Mode", "website": "https://maison-adjara.example", "description": "Prêt-à-porter en wax, fabriqué à Cotonou.", "tone": "Chaleureux et fier", "audience": "Femmes actives 25-40 ans", "hashtags": [ "#wax", "#madeinbenin" ], "accounts": [ { "object": "social_account", "id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "display_name": "Maison Adjara", "username": null, "status": "connected" }, { "object": "social_account", "id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "display_name": "Maison Adjara", "username": "maisonadjara", "status": "connected" } ], "created_at": "2026-09-01T09:00:00.000Z", "updated_at": "2026-10-02T11:00:00.000Z" } ``` ### Erreurs spécifiques 404 Marque introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Stratégie éditoriale d’une marque GET `/api/platform/v1/brands/:id/strategy` social:read Retourne les objectifs, piliers, cadence et plan de publication de la marque. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la marque. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10/strategy' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10/strategy', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10/strategy", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "social_strategy", "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "active", "goals": "Faire connaître la nouvelle collection et générer des ventes via WhatsApp.", "pillars": [ { "name": "Coulisses de l’atelier", "description": "Fabrication, artisans, tissus." } ], "cadence": { "facebook": 3, "instagram": 5 }, "plan": [ { "date": "2026-10-20", "provider": "instagram", "format": "carousel", "topic": "Les 3 pièces de la rentrée" } ], "generated_at": "2026-10-01T10:00:00.000Z", "created_at": "2026-10-01T10:00:00.000Z", "updated_at": "2026-10-01T10:00:00.000Z" } ``` ### Erreurs spécifiques 404 Marque ou stratégie introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `get_brand_strategy`. ## Lister les publications GET `/api/platform/v1/social/posts` social:read Retourne les publications, filtrables par marque, statut et période. ### Paramètres de requête Champ Type Description `brand_id` uuid Publications d’une marque. `status` string Un des statuts de publication. `from` datetime Prévues ou publiées à partir de cette date. `to` datetime Prévues ou publiées avant cette date. `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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/social/posts?brand_id=8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10&status=scheduled' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/social/posts?brand_id=8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10&status=scheduled', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/social/posts", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, params={ "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "scheduled", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "social_post", "id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "scheduled", "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "link_url": null, "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "pillar": null, "scheduled_at": "2026-10-20T09:00:00.000Z", "published_at": null, "approved_at": null, "author_id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "approved_by": null, "rejected_reason": null, "targets": [ { "account_id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null }, { "account_id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null } ], "version": 1, "created_at": "2026-10-16T10:00:00.000Z", "updated_at": "2026-10-16T10:00:00.000Z" } ], "has_more": false, "next_cursor": null } ``` Équivalent pour les agents IA : l'outil MCP `list_social_posts`. ## Récupérer une publication GET `/api/platform/v1/social/posts/:id` social:read Retourne une publication et l’état de chaque réseau ciblé. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la publication. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "social_post", "id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "pending_approval", "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "link_url": null, "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "pillar": null, "scheduled_at": "2026-10-20T09:00:00.000Z", "published_at": null, "approved_at": null, "author_id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "approved_by": null, "rejected_reason": null, "targets": [ { "account_id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null }, { "account_id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null } ], "version": 1, "created_at": "2026-10-16T10:00:00.000Z", "updated_at": "2026-10-16T10:00:00.000Z" } ``` ### Erreurs spécifiques 404 Publication introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Créer une publication POST `/api/platform/v1/social/posts` social:write Crée une publication pour une marque et un ou plusieurs comptes. `action` détermine la suite : `draft` (brouillon), `submit` (envoi en validation) ou `schedule` (planification, exige `scheduled_at` et le scope `social:publish`). Sans `social:publish` (ou sans droits de gestion pour l’agent d’un membre de l’équipe), une demande de planification est transformée en demande de validation : la publication passe en `pending_approval` et la réponse contient un champ `notice` qui l’explique. ### Corps de la requête (JSON) Champ Type Description `brand_id` requis uuid Marque. `account_ids` requis uuid[] Comptes sociaux de la marque à cibler. `body` requis string Texte de la publication. `title` string Titre interne (160 caractères max.). `media` array Jusqu’à 20 médias `{ "url": "https://…", "type": "image" | "video" }`, accessibles publiquement. `link_url` string Lien à joindre (http/https). `overrides` object Texte par réseau : `{ "instagram": { "body": "…" } }`. `pillar` string Pilier éditorial (80 caractères max.). `scheduled_at` datetime Date de publication souhaitée (ISO 8601). `action` string `draft` (défaut), `submit` ou `schedule`. ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/social/posts' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "account_ids": [ "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82" ], "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "scheduled_at": "2026-10-20T09:00:00Z", "action": "schedule" }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/social/posts', { method: 'POST', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID(), }, body: JSON.stringify({ "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "account_ids": [ "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82" ], "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "scheduled_at": "2026-10-20T09:00:00Z", "action": "schedule" }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import uuid import requests response = requests.post( "https://strikespace.net/api/platform/v1/social/posts", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}, json={ "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "account_ids": ["c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82"], "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image", }, ], "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax", }, }, "scheduled_at": "2026-10-20T09:00:00Z", "action": "schedule", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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([ 'brand_id' => '8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10', 'account_ids' => ['c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71', 'c51ce410-c124-4a10-9e5b-8c4d5e6f7a82'], 'title' => 'Lancement collection', 'body' => 'La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.', 'media' => [ [ 'url' => 'https://cdn.example.com/collection.jpg', 'type' => 'image', ], ], 'overrides' => [ 'instagram' => [ 'body' => 'La nouvelle collection est arrivée ✨ #wax', ], ], 'scheduled_at' => '2026-10-20T09:00:00Z', 'action' => 'schedule', ]), ]); $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 Exemple avec action « schedule » demandé sans le scope social:publish. Réponse 201 ```json { "object": "social_post", "id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "pending_approval", "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "link_url": null, "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "pillar": null, "scheduled_at": "2026-10-20T09:00:00.000Z", "published_at": null, "approved_at": null, "author_id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "approved_by": null, "rejected_reason": null, "targets": [ { "account_id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null }, { "account_id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null } ], "version": 1, "created_at": "2026-10-16T10:00:00.000Z", "updated_at": "2026-10-16T10:00:00.000Z", "notice": "La publication a été soumise pour validation : la planification demande la permission social:publish et des droits de gestion." } ``` ### Erreurs spécifiques 422 Paramètre invalide (`invalid_request`) ; `param` indique le champ en cause. 404 Marque ou compte social introuvable, ou appartenant à un autre compte (`not_found`). 403 Quota de publications de l’offre atteint (`permission_error`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `create_social_post`. ## Modifier une publication PATCH `/api/platform/v1/social/posts/:id` social:write Modifie le texte, les médias, les comptes ciblés ou la date. Envoyez `base_version` (la `version` que vous avez lue) : si quelqu’un a modifié la publication entre-temps, l’API répond `409` au lieu d’écraser son travail. Une publication approuvée ou planifiée qui est modifiée repasse en validation si votre clé n’a pas `social:publish`. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la publication. ### Corps de la requête (JSON) Champ Type Description `base_version` integer Version lue avant modification (recommandé) : protège contre l’écrasement d’une modification concurrente. `body` string Texte. `title` string Titre interne. `account_ids` uuid[] Comptes ciblés. `media` array Médias. `link_url` string | null Lien joint. `overrides` object Texte par réseau. `pillar` string | null Pilier éditorial. `scheduled_at` datetime | null Date souhaitée. ### Exemple de requête ```curl curl -X PATCH 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "base_version": 1, "body": "La nouvelle collection est arrivée ! 3 pièces, 3 couleurs." }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67', { method: 'PATCH', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "base_version": 1, "body": "La nouvelle collection est arrivée ! 3 pièces, 3 couleurs." }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import requests response = requests.patch( "https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, json={ "base_version": 1, "body": "La nouvelle collection est arrivée ! 3 pièces, 3 couleurs.", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('STRIKE_API_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'base_version' => 1, 'body' => 'La nouvelle collection est arrivée ! 3 pièces, 3 couleurs.', ]), ]); $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 ```json { "object": "social_post", "id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "pending_approval", "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! 3 pièces, 3 couleurs.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "link_url": null, "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "pillar": null, "scheduled_at": "2026-10-20T09:00:00.000Z", "published_at": null, "approved_at": null, "author_id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "approved_by": null, "rejected_reason": null, "targets": [ { "account_id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null }, { "account_id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null } ], "version": 2, "created_at": "2026-10-16T10:00:00.000Z", "updated_at": "2026-10-16T10:00:00.000Z" } ``` ### Erreurs spécifiques 404 Publication introuvable, ou appartenant à un autre compte (`not_found`). 409 Version obsolète, ou publication déjà publiée (`conflict`). 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](https://strikespace.net/developpeurs/conventions#erreurs). ## Envoyer en validation POST `/api/platform/v1/social/posts/:id/submit` social:write Passe un brouillon (ou une publication en échec) en `pending_approval` et notifie les validateurs de votre équipe. Émet `social.post.pending_approval`. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la publication. ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/submit' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/submit', { method: 'POST', 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) ``` ```python import os import requests response = requests.post( "https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/submit", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'POST', 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 ```json { "object": "social_post", "id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "pending_approval", "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "link_url": null, "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "pillar": null, "scheduled_at": "2026-10-20T09:00:00.000Z", "published_at": null, "approved_at": null, "author_id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "approved_by": null, "rejected_reason": null, "targets": [ { "account_id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null }, { "account_id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null } ], "version": 1, "created_at": "2026-10-16T10:00:00.000Z", "updated_at": "2026-10-16T10:00:00.000Z" } ``` ### Erreurs spécifiques 404 Publication introuvable, ou appartenant à un autre compte (`not_found`). 409 La publication n’est pas un brouillon (`conflict`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Planifier une publication POST `/api/platform/v1/social/posts/:id/schedule` social:publish Approuve et planifie la publication à `scheduled_at`. Elle sera publiée automatiquement sur chaque compte ciblé. Émet `social.post.scheduled`. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la publication. ### Corps de la requête (JSON) Champ Type Description `scheduled_at` requis datetime Date de publication, dans le futur (ISO 8601). ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/schedule' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "scheduled_at": "2026-10-20T09:00:00Z" }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/schedule', { method: 'POST', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "scheduled_at": "2026-10-20T09:00:00Z" }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import requests response = requests.post( "https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/schedule", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, json={ "scheduled_at": "2026-10-20T09:00:00Z", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('STRIKE_API_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'scheduled_at' => '2026-10-20T09:00:00Z', ]), ]); $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 ```json { "object": "social_post", "id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "scheduled", "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "link_url": null, "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "pillar": null, "scheduled_at": "2026-10-20T09:00:00.000Z", "published_at": null, "approved_at": null, "author_id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "approved_by": null, "rejected_reason": null, "targets": [ { "account_id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null }, { "account_id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null } ], "version": 1, "created_at": "2026-10-16T10:00:00.000Z", "updated_at": "2026-10-16T10:00:00.000Z" } ``` ### Erreurs spécifiques 404 Publication introuvable, ou appartenant à un autre compte (`not_found`). 422 Paramètre invalide (`invalid_request`) ; `param` indique le champ en cause. 409 Statut incompatible (déjà publiée, annulée…) (`conflict`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). Équivalent pour les agents IA : l'outil MCP `schedule_social_post`. ## Publier immédiatement POST `/api/platform/v1/social/posts/:id/publish` social:publish Met la publication en file de publication immédiate. Le résultat par réseau arrive de façon asynchrone : suivez `social.post.published` / `social.post.failed` par webhook, ou relisez la publication. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la publication. ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/publish' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/publish', { method: 'POST', 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) ``` ```python import os import requests response = requests.post( "https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/publish", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'POST', 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 ```json { "object": "social_post", "id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", "brand_id": "8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10", "status": "publishing", "title": "Lancement collection", "body": "La nouvelle collection est arrivée ! Découvrez nos 3 pièces phares.", "media": [ { "url": "https://cdn.example.com/collection.jpg", "type": "image" } ], "link_url": null, "overrides": { "instagram": { "body": "La nouvelle collection est arrivée ✨ #wax" } }, "pillar": null, "scheduled_at": null, "published_at": null, "approved_at": null, "author_id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "approved_by": null, "rejected_reason": null, "targets": [ { "account_id": "c20ad4d7-6fe9-4759-8aa2-7b3c4d5e6f71", "provider": "facebook", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null }, { "account_id": "c51ce410-c124-4a10-9e5b-8c4d5e6f7a82", "provider": "instagram", "status": "pending", "permalink": null, "external_post_id": null, "error": null, "published_at": null } ], "version": 1, "created_at": "2026-10-16T10:00:00.000Z", "updated_at": "2026-10-16T10:00:00.000Z" } ``` ### Erreurs spécifiques 404 Publication introuvable, ou appartenant à un autre compte (`not_found`). 409 Statut incompatible (`conflict`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Supprimer un brouillon DELETE `/api/platform/v1/social/posts/:id` social:write Supprime un brouillon, comme dans le dashboard (ainsi qu’une publication annulée ou en échec). Une publication déjà en ligne n’est jamais retirée des réseaux. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la publication. ### Exemple de requête ```curl curl -X DELETE 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67', { method: 'DELETE', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, }, }) if (!response.ok) throw new Error((await response.json()).error.message) ``` ```python import os import requests response = requests.delete( "https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() ``` ```php true, CURLOPT_CUSTOMREQUEST => 'DELETE', 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 ```json { "object": "social_post", "id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67", "deleted": true } ``` ### Erreurs spécifiques 404 Publication introuvable, ou appartenant à un autre compte (`not_found`). 409 La publication est planifiée, en cours ou déjà publiée (`conflict`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). --- # Paiements Source : https://strikespace.net/developpeurs/paiements Lire les ventes encaissées par vos tunnels (Mobile Money et carte). Les paiements sont les ventes réalisées dans vos tunnels via FedaPay, CinetPay, Moneroo ou Stripe. Les montants sont des entiers dans la devise indiquée (FCFA : `XOF`). Les notifications des passerelles sont reçues directement par STRIKE : abonnez-vous à `payment.succeeded` pour être prévenu en temps réel. GET `/payments` Lister les paiements ## L'objet payment Champ Type Description `id` uuid Identifiant du paiement. `amount` integer Montant, en unités de la devise (FCFA). `currency` string Devise ISO 4217, par exemple `XOF`. `status` string `pending`, `succeeded` ou `failed`. `provider` string Passerelle : `fedapay`, `cinetpay`, `moneroo`, `stripe`. `reference` string Référence de la transaction chez STRIKE / la passerelle. `funnel_id` uuid | null Tunnel de la vente. `lead_id` uuid | null Acheteur. `created_at` datetime Date du paiement. ## Lister les paiements GET `/api/platform/v1/payments` payments:read Retourne les ventes des tunnels, de la plus récente à la plus ancienne. Les abonnements STRIKE ne sont pas inclus. ### Paramètres de requête Champ Type Description `status` string `pending`, `succeeded` ou `failed`. `funnel_id` uuid Ventes d’un tunnel. `lead_id` uuid Achats d’un lead. `created_after` datetime À partir de cette date (ISO 8601). `created_before` datetime Avant 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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/payments?status=succeeded&limit=50' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/payments?status=succeeded&limit=50', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/payments", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, params={ "status": "succeeded", "limit": 50, }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "payment", "id": "d3d94468-02a4-4b3c-9d5e-6f7a8b9c0d13", "amount": 15000, "currency": "XOF", "status": "succeeded", "provider": "fedapay", "reference": "STRK-FNL-20261015-8F14", "funnel_id": "3c59dc04-8f1e-4b6a-9d2c-1e5f7a9b0c21", "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "created_at": "2026-10-15T16:01:00.000Z", "updated_at": "2026-10-15T16:01:20.000Z" } ], "has_more": false, "next_cursor": null } ``` Équivalent pour les agents IA : l'outil MCP `list_payments`. --- # Endpoints de webhooks Source : https://strikespace.net/developpeurs/webhooks-api Créer et gérer par l’API les URL qui reçoivent vos événements STRIKE. Ces endpoints gèrent vos abonnements webhooks par programme ; vous pouvez faire la même chose depuis Développeurs → Webhooks dans le dashboard. Le format des événements, la vérification de signature et la politique de renvoi sont décrits dans le [guide Webhooks](https://strikespace.net/developpeurs/webhooks). Tous ces endpoints exigent le scope `webhooks:manage`. GET `/webhook_endpoints` Lister les endpoints POST `/webhook_endpoints` Créer un endpoint GET `/webhook_endpoints/:id` Récupérer un endpoint PATCH `/webhook_endpoints/:id` Modifier un endpoint DELETE `/webhook_endpoints/:id` Supprimer un endpoint POST `/webhook_endpoints/:id/rotate_secret` Renouveler le secret POST `/webhook_endpoints/:id/test` Envoyer un événement de test GET `/webhook_endpoints/:id/deliveries` Historique des livraisons POST `/webhook_deliveries/:id/retry` Renvoyer une livraison ## L'objet webhook_endpoint Champ Type Description `id` uuid Identifiant de l’endpoint. `url` string URL HTTPS publique qui reçoit les événements. `description` string | null Libellé libre. `events` string[] Types d’événements, ou `["*"]` pour tous (sauf `event.tracked`). `status` string `active` ou `disabled`. `disabled_reason` string | null Raison de la désactivation automatique. `consecutive_failures` integer Livraisons consécutives en échec (désactivation à 20). `secret_rotating_until` datetime | null Pendant une rotation : fin de validité de l’ancien secret. `last_delivery_at` datetime | null Dernière livraison. `secret` string Secret de signature `whsec_…`, retourné uniquement à la création et à la rotation. ## Lister les endpoints GET `/api/platform/v1/webhook_endpoints` webhooks:manage Retourne vos endpoints (sans leur secret). ### Paramètres de requête Champ Type Description `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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/webhook_endpoints' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/webhook_endpoints", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "webhook_endpoint", "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "url": "https://crm.example.com/strike/webhooks", "description": "Synchronisation CRM", "events": [ "lead.created", "lead.updated", "payment.succeeded" ], "status": "active", "disabled_reason": null, "consecutive_failures": 0, "secret_rotating_until": null, "last_delivery_at": "2026-10-16T10:05:52.000Z", "created_at": "2026-10-16T09:00:00.000Z", "updated_at": "2026-10-16T09:00:00.000Z" } ], "has_more": false, "next_cursor": null } ``` Équivalent pour les agents IA : l'outil MCP `list_webhook_endpoints`. ## Créer un endpoint POST `/api/platform/v1/webhook_endpoints` webhooks:manage Enregistre une URL. La réponse contient le `secret` de signature : conservez-le immédiatement dans votre gestionnaire de secrets, il ne sera plus jamais affiché. ### Corps de la requête (JSON) Champ Type Description `url` requis string URL HTTPS publique, sans identifiants. Refusées : `localhost`, noms `.local` / `.internal` ou sans domaine, adresses IP privées. `events` requis string[] 1 à 30 types du [catalogue](https://strikespace.net/developpeurs/webhooks#catalogue) (hors `ping`), ou `["*"]`. `description` string Libellé libre. ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "url": "https://crm.example.com/strike/webhooks", "events": [ "lead.created", "lead.updated", "payment.succeeded" ], "description": "Synchronisation CRM" }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints', { method: 'POST', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID(), }, body: JSON.stringify({ "url": "https://crm.example.com/strike/webhooks", "events": [ "lead.created", "lead.updated", "payment.succeeded" ], "description": "Synchronisation CRM" }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import uuid import requests response = requests.post( "https://strikespace.net/api/platform/v1/webhook_endpoints", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}, json={ "url": "https://crm.example.com/strike/webhooks", "events": ["lead.created", "lead.updated", "payment.succeeded"], "description": "Synchronisation CRM", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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([ 'url' => 'https://crm.example.com/strike/webhooks', 'events' => ['lead.created', 'lead.updated', 'payment.succeeded'], 'description' => 'Synchronisation CRM', ]), ]); $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 ```json { "object": "webhook_endpoint", "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "url": "https://crm.example.com/strike/webhooks", "description": "Synchronisation CRM", "events": [ "lead.created", "lead.updated", "payment.succeeded" ], "status": "active", "disabled_reason": null, "consecutive_failures": 0, "secret_rotating_until": null, "last_delivery_at": "2026-10-16T10:05:52.000Z", "created_at": "2026-10-16T09:00:00.000Z", "updated_at": "2026-10-16T09:00:00.000Z", "secret": "whsec_8Kd2mP4qR7sT9vW1xY3zA5bC6dE8fG0h" } ``` ### Erreurs spécifiques 422 Paramètre invalide (`invalid_request`) ; `param` indique le champ en cause. 409 Nombre maximal d’endpoints de votre offre atteint (`conflict`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Récupérer un endpoint GET `/api/platform/v1/webhook_endpoints/:id` webhooks:manage Retourne un endpoint (sans son secret). ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de l’endpoint. ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "webhook_endpoint", "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "url": "https://crm.example.com/strike/webhooks", "description": "Synchronisation CRM", "events": [ "lead.created", "lead.updated", "payment.succeeded" ], "status": "active", "disabled_reason": null, "consecutive_failures": 0, "secret_rotating_until": null, "last_delivery_at": "2026-10-16T10:05:52.000Z", "created_at": "2026-10-16T09:00:00.000Z", "updated_at": "2026-10-16T09:00:00.000Z" } ``` ### Erreurs spécifiques 404 Endpoint introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Modifier un endpoint PATCH `/api/platform/v1/webhook_endpoints/:id` webhooks:manage Modifie l’URL, les événements, la description, ou désactive / réactive l’endpoint. Un endpoint désactivé automatiquement se réactive avec `"status": "active"` (le compteur d’échecs repart de zéro). ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de l’endpoint. ### Corps de la requête (JSON) Champ Type Description `url` string Nouvelle URL HTTPS. `events` string[] Nouvelle liste d’événements. `description` string | null Libellé. `status` string `active` ou `disabled`. ### Exemple de requête ```curl curl -X PATCH 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "events": [ "*" ], "status": "active" }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', { method: 'PATCH', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "events": [ "*" ], "status": "active" }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import requests response = requests.patch( "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, json={ "events": ["*"], "status": "active", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('STRIKE_API_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'events' => ['*'], 'status' => 'active', ]), ]); $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 ```json { "object": "webhook_endpoint", "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "url": "https://crm.example.com/strike/webhooks", "description": "Synchronisation CRM", "events": [ "*" ], "status": "active", "disabled_reason": null, "consecutive_failures": 0, "secret_rotating_until": null, "last_delivery_at": "2026-10-16T10:05:52.000Z", "created_at": "2026-10-16T09:00:00.000Z", "updated_at": "2026-10-16T09:00:00.000Z" } ``` ### Erreurs spécifiques 404 Endpoint introuvable, ou appartenant à un autre compte (`not_found`). 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](https://strikespace.net/developpeurs/conventions#erreurs). ## Supprimer un endpoint DELETE `/api/platform/v1/webhook_endpoints/:id` webhooks:manage Supprime l’endpoint et son historique de livraisons. Les livraisons en attente sont abandonnées. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de l’endpoint. ### Exemple de requête ```curl curl -X DELETE 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12', { method: 'DELETE', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, }, }) if (!response.ok) throw new Error((await response.json()).error.message) ``` ```python import os import requests response = requests.delete( "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() ``` ```php true, CURLOPT_CUSTOMREQUEST => 'DELETE', 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 ```json { "object": "webhook_endpoint", "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "deleted": true } ``` ### Erreurs spécifiques 404 Endpoint introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Renouveler le secret POST `/api/platform/v1/webhook_endpoints/:id/rotate_secret` webhooks:manage Génère un nouveau secret et le retourne une seule fois. Pendant 24 heures, chaque livraison porte deux signatures `v1` (ancien et nouveau secret) : déployez le nouveau secret sans interruption, puis l’ancien cesse d’être utilisé. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de l’endpoint. ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret', { method: 'POST', 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) ``` ```python import os import requests response = requests.post( "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/rotate_secret", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'POST', 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 ```json { "object": "webhook_endpoint", "id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "url": "https://crm.example.com/strike/webhooks", "description": "Synchronisation CRM", "events": [ "lead.created", "lead.updated", "payment.succeeded" ], "status": "active", "disabled_reason": null, "consecutive_failures": 0, "secret_rotating_until": "2026-10-17T10:00:00.000Z", "last_delivery_at": "2026-10-16T10:05:52.000Z", "created_at": "2026-10-16T09:00:00.000Z", "updated_at": "2026-10-16T09:00:00.000Z", "secret": "whsec_Q1w2E3r4T5y6U7i8O9p0A1s2D3f4G5h6" } ``` ### Erreurs spécifiques 404 Endpoint introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Envoyer un événement de test POST `/api/platform/v1/webhook_endpoints/:id/test` webhooks:manage Envoie immédiatement un événement `ping` signé à l’URL (une seule tentative) et retourne la livraison avec la réponse de votre serveur. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de l’endpoint. ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test', { method: 'POST', 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) ``` ```python import os import requests response = requests.post( "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/test", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'POST', 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 ```json { "object": "webhook_delivery", "id": "aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74", "endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "event_id": "evt_9xQ2wE4rT6yU8iO0pA1sD3fG", "event_type": "ping", "status": "succeeded", "attempts": 1, "response_status": 200, "response_excerpt": "ok", "error": null, "next_attempt_at": null, "delivered_at": "2026-10-16T10:06:00.000Z", "created_at": "2026-10-16T10:05:51.000Z", "payload": { "id": "evt_9xQ2wE4rT6yU8iO0pA1sD3fG", "object": "event", "type": "ping", "data": { "object": { "object": "ping", "message": "Ceci est un test envoyé depuis STRIKE.", "endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12" } } } } ``` ### Erreurs spécifiques 404 Endpoint introuvable, ou appartenant à un autre compte (`not_found`). 409 Endpoint désactivé : réactivez-le avant de le tester (`conflict`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Historique des livraisons GET `/api/platform/v1/webhook_endpoints/:id/deliveries` webhooks:manage Retourne les livraisons des 30 derniers jours, de la plus récente à la plus ancienne, avec le code HTTP, un extrait de votre réponse (1 000 caractères max.) et le contenu envoyé (`payload`). ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de l’endpoint. ### Paramètres de requête Champ Type Description `status` string `pending`, `succeeded` ou `failed`. `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](https://strikespace.net/developpeurs/conventions#pagination). ### Exemple de requête ```curl curl 'https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries?status=failed' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries?status=failed', { 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) ``` ```python import os import requests response = requests.get( "https://strikespace.net/api/platform/v1/webhook_endpoints/45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12/deliveries", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, params={ "status": "failed", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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 ```json { "object": "list", "data": [ { "object": "webhook_delivery", "id": "aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74", "endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "event_id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z", "event_type": "lead.created", "status": "pending", "attempts": 3, "response_status": 503, "response_excerpt": "Service Unavailable", "error": null, "next_attempt_at": "2026-10-16T10:42:00.000Z", "delivered_at": null, "created_at": "2026-10-16T10:05:51.000Z", "payload": { "id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z", "object": "event", "type": "lead.created", "data": { "object": { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80" } } } } ], "has_more": false, "next_cursor": null } ``` ### Erreurs spécifiques 404 Endpoint introuvable, ou appartenant à un autre compte (`not_found`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). ## Renvoyer une livraison POST `/api/platform/v1/webhook_deliveries/:id/retry` webhooks:manage Crée une nouvelle livraison du même événement (même `Strike-Event-Id`, nouveau `Strike-Delivery-Id`) et l’envoie immédiatement. Votre code doit donc dédoublonner sur l’identifiant d’événement. ### Paramètres de chemin Champ Type Description `id` requis uuid Identifiant de la livraison. ### Exemple de requête ```curl curl -X POST 'https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry' \ -H "Authorization: Bearer $STRIKE_API_KEY" ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry', { method: 'POST', 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) ``` ```python import os import requests response = requests.post( "https://strikespace.net/api/platform/v1/webhook_deliveries/aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74/retry", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"}, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php true, CURLOPT_CUSTOMREQUEST => 'POST', 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 ```json { "object": "webhook_delivery", "id": "bb43c4d5-e6f7-4a8b-9c0d-1e2f3a4b5c6d", "endpoint_id": "45c48cce-2e2d-4fbd-8a3b-6c7d8e9f0a12", "event_id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z", "event_type": "lead.created", "status": "pending", "attempts": 0, "response_status": null, "response_excerpt": null, "error": null, "next_attempt_at": "2026-10-16T10:30:00.000Z", "delivered_at": null, "created_at": "2026-10-16T10:05:51.000Z", "payload": { "id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z", "object": "event", "type": "lead.created", "data": { "object": { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80" } } } } ``` ### Erreurs spécifiques 404 Livraison introuvable, ou appartenant à un autre compte (`not_found`). 409 Endpoint désactivé (`conflict`). Les erreurs communes (401, 403 `insufficient_scope` / `plan_required`, 429) sont décrites dans [Conventions](https://strikespace.net/developpeurs/conventions#erreurs). --- # Webhooks Source : https://strikespace.net/developpeurs/webhooks Recevez les événements STRIKE en temps réel, signés et renvoyés en cas d’échec. Les webhooks envoient une requête `POST` signée à votre serveur dès qu'un événement se produit dans STRIKE : nouveau lead, paiement encaissé, publication en ligne… Plus besoin d'interroger l'API en boucle. ## Configurer un endpoint - Dans votre dashboard, ouvrez Développeurs → Webhooks (propriétaire ou administrateur, offre Pro ou Enterprise). - Indiquez l'URL HTTPS publique qui recevra les événements et choisissez les types d'événements (ou tous, `*`). - Copiez le secret de signature `whsec_…` : il n'est affiché qu'une seule fois. - Cliquez sur Tester pour recevoir un événement `ping`. Vous pouvez aussi gérer vos endpoints par programme avec le scope `webhooks:manage` (voir [Endpoints de webhooks](https://strikespace.net/developpeurs/webhooks-api)) : ```curl curl -X POST 'https://strikespace.net/api/platform/v1/webhook_endpoints' \ -H "Authorization: Bearer $STRIKE_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "url": "https://crm.example.com/strike/webhooks", "events": [ "lead.created", "payment.succeeded" ], "description": "Synchronisation CRM" }' ``` ```node // Node.js 18+ (fetch natif) const response = await fetch('https://strikespace.net/api/platform/v1/webhook_endpoints', { method: 'POST', headers: { Authorization: `Bearer ${process.env.STRIKE_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID(), }, body: JSON.stringify({ "url": "https://crm.example.com/strike/webhooks", "events": [ "lead.created", "payment.succeeded" ], "description": "Synchronisation CRM" }), }) const data = await response.json() if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`) console.log(data) ``` ```python import os import uuid import requests response = requests.post( "https://strikespace.net/api/platform/v1/webhook_endpoints", headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}, json={ "url": "https://crm.example.com/strike/webhooks", "events": ["lead.created", "payment.succeeded"], "description": "Synchronisation CRM", }, timeout=10, ) response.raise_for_status() print(response.json()) ``` ```php 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([ 'url' => 'https://crm.example.com/strike/webhooks', 'events' => ['lead.created', 'payment.succeeded'], 'description' => 'Synchronisation CRM', ]), ]); $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'); } ``` 5 endpoints maximum en Pro, 25 en Enterprise. L'URL doit être en HTTPS, sans identifiants, et désigner un hôte public : `localhost`, les noms `.local` / `.internal` ou sans domaine et les adresses IP privées sont refusés. L'adresse est revérifiée à chaque envoi (protection SSRF). ## Catalogue des événements Type `data.object` Déclenché quand `lead.created` `lead` Un nouveau lead a été capté (tunnel, API, tracking ou intégration). `lead.updated` `lead` Les informations, le statut ou les traits d’un lead ont changé. `lead.converted` `lead` Un lead est passé au statut « converti » (achat ou mise à jour manuelle). `lead.deleted` `lead` Un lead a été supprimé (seul son identifiant est envoyé). `event.tracked` sur demande `event` Un événement de tracking a été enregistré. Volume élevé : jamais inclus dans « Tous les événements ». Volume élevé : jamais inclus dans « * », à cocher explicitement. `payment.succeeded` `payment` Une vente réalisée via un tunnel a été payée. `payment.failed` `payment` Le paiement d’une vente de tunnel a été refusé. `journey.enrollment.created` `journey_enrollment` Un lead est entré dans un parcours automatisé. `journey.enrollment.completed` `journey_enrollment` Un lead est arrivé au bout d’un parcours. `social.post.pending_approval` `social_post` Une publication a été soumise pour validation. `social.post.scheduled` `social_post` Une publication a été planifiée. `social.post.published` `social_post` Une publication a été publiée sur au moins un réseau. `social.post.failed` `social_post` La publication a échoué sur tous les réseaux visés. `ping` `ping` Événement de test envoyé par le bouton « Tester ». Ne peut pas être choisi dans un abonnement. `data.object` a exactement le même format que la ressource correspondante de l'API REST (par exemple [l'objet lead](https://strikespace.net/developpeurs/leads#objet)). De nouveaux types d'événements peuvent être ajoutés : ignorez ceux que vous ne connaissez pas. ## Format d'une livraison HTTP ```http POST /strike/webhooks HTTP/1.1 Host: crm.example.com Content-Type: application/json User-Agent: StrikeSpace-Webhooks/1.0 Strike-Event-Id: evt_4Fz9kQ2LmN8pR1sT6vW3xY5z Strike-Event-Type: lead.created Strike-Delivery-Id: aab32389-22bc-4c0d-8e1f-2a3b4c5d6e74 Strike-Signature: t=1792145551,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd ``` Corps (JSON) ```json { "id": "evt_4Fz9kQ2LmN8pR1sT6vW3xY5z", "object": "event", "type": "lead.created", "created_at": "2026-10-16T10:05:51.000Z", "api_version": "2026-10-01", "workspace_id": "b6d767d2-f8ed-4c21-9a6f-3e4d5c6b7a85", "data": { "object": { "object": "lead", "id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp", "status": "cold", "funnel_id": null, "traits": { "source": "crm" }, "created_at": "2026-10-16T10:05:51.000Z" } } } ``` En-tête Contenu `Strike-Event-Id` Identifiant unique de l'événement (`evt_…`), identique au champ `id` et stable entre les renvois. `Strike-Event-Type` Type de l'événement, identique au champ `type`. `Strike-Delivery-Id` Identifiant de la livraison (une par endpoint et par événement), visible dans l'historique. `Strike-Signature` `t=,v1=` — voir ci-dessous. `User-Agent` `StrikeSpace-Webhooks/1.0` ## Vérifier la signature Vérifiez chaque requête avant de la traiter : n'importe qui peut envoyer un `POST` à votre URL. La signature `v1` est un HMAC-SHA256, encodé en hexadécimal, calculé avec votre secret `whsec_…` sur la chaîne : ```text . ``` - Lisez le corps brut, tel que reçu, avant tout parsing JSON (un JSON ré-encodé ne donne pas la même signature). - Extrayez `t` et toutes les valeurs `v1` de l'en-tête `Strike-Signature`. - Refusez la requête si `t` est écarté de plus de 300 secondes de votre horloge (protection contre le rejeu). - Calculez le HMAC attendu et comparez-le à chaque `v1` avec une comparaison à temps constant. - Acceptez si au moins une signature correspond ; sinon répondez `400`. ```node // Node.js 18+ / Express — vérification de la signature STRIKE import crypto from 'node:crypto' import express from 'express' const TOLERANCE_SECONDS = 300 // Pendant une rotation, mettez l'ancien ET le nouveau secret. const SECRETS = [process.env.STRIKE_WEBHOOK_SECRET] export function verifyStrikeSignature(rawBody, header, secrets) { if (!header) return false const parts = header.split(',').map((part) => part.trim()) const timestamp = Number(parts.find((part) => part.startsWith('t='))?.slice(2)) const signatures = parts.filter((part) => part.startsWith('v1=')).map((part) => part.slice(3)) if (!Number.isInteger(timestamp) || signatures.length === 0) return false if (Math.abs(Date.now() / 1000 - timestamp) > TOLERANCE_SECONDS) return false const signedPayload = `${timestamp}.${rawBody}` return secrets.some((secret) => { const expected = Buffer.from(crypto.createHmac('sha256', secret).update(signedPayload).digest('hex')) return signatures.some((signature) => { const received = Buffer.from(signature) return received.length === expected.length && crypto.timingSafeEqual(received, expected) }) }) } const app = express() // Corps BRUT : ne laissez pas express.json() le réécrire avant la vérification. app.post('/strike/webhooks', express.raw({ type: 'application/json' }), async (req, res) => { const rawBody = req.body.toString('utf8') if (!verifyStrikeSignature(rawBody, req.get('Strike-Signature'), SECRETS)) { return res.status(400).send('Signature invalide') } const event = JSON.parse(rawBody) if (await alreadyProcessed(event.id)) return res.sendStatus(200) // dédoublonnage await jobs.enqueue(event) // traitement asynchrone res.sendStatus(200) // répondez en moins de 10 s }) ``` ```php TOLERANCE_SECONDS) { return false; } foreach ($secrets as $secret) { $expected = hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret); foreach ($signatures as $signature) { if (hash_equals($expected, $signature)) { return true; } } } return false; } $rawBody = file_get_contents('php://input'); $header = $_SERVER['HTTP_STRIKE_SIGNATURE'] ?? null; // Pendant une rotation, mettez l'ancien ET le nouveau secret. $secrets = [getenv('STRIKE_WEBHOOK_SECRET')]; if (!verifyStrikeSignature($rawBody, $header, $secrets)) { http_response_code(400); exit('Signature invalide'); } $event = json_decode($rawBody, true); // Dédoublonnez sur $event['id'], mettez le traitement en file, puis répondez vite. http_response_code(200); ``` ```python # Python 3.9+ / Flask — vérification de la signature STRIKE import hashlib import hmac import os import time from flask import Flask, abort, request TOLERANCE_SECONDS = 300 # Pendant une rotation, mettez l'ancien ET le nouveau secret. SECRETS = [os.environ["STRIKE_WEBHOOK_SECRET"]] def verify_strike_signature(raw_body: bytes, header: str | None, secrets: list[str]) -> bool: if not header: return False timestamp, signatures = None, [] for part in header.split(","): key, _, value = part.strip().partition("=") if key == "t": timestamp = value elif key == "v1": signatures.append(value) if not timestamp or not timestamp.isdigit() or not signatures: return False if abs(time.time() - int(timestamp)) > TOLERANCE_SECONDS: return False signed_payload = timestamp.encode() + b"." + raw_body for secret in secrets: expected = hmac.new(secret.encode(), signed_payload, hashlib.sha256).hexdigest() if any(hmac.compare_digest(expected, signature) for signature in signatures): return True return False app = Flask(__name__) @app.post("/strike/webhooks") def strike_webhook(): raw_body = request.get_data() # corps brut, avant tout parsing if not verify_strike_signature(raw_body, request.headers.get("Strike-Signature"), SECRETS): abort(400) event = request.get_json() # Dédoublonnez sur event["id"], mettez le traitement en file, puis répondez vite. return "", 200 ``` ### Rotation du secret Renouvelez le secret depuis le dashboard ou avec `POST /webhook_endpoints/:id/rotate_secret`. Pendant 24 heures, chaque livraison porte deux signatures `v1`, l'une avec le nouveau secret, l'autre avec l'ancien : Pendant une rotation ```text Strike-Signature: t=1792145551,v1=,v1= ``` Ajoutez le nouveau secret à votre liste `SECRETS`, déployez, puis retirez l'ancien avant la date indiquée par `secret_rotating_until` sur l'endpoint. Aucune livraison n'est perdue pendant la transition. ## Renvois et désactivation Une livraison réussit quand votre serveur répond un code `2xx` en moins de 10 secondes. Les redirections ne sont pas suivies. - Erreur réseau, délai dépassé, `5xx` ou `429` : nouvelle tentative selon le calendrier ci-dessous. - Autre code `4xx` ou redirection (`3xx`) : échec définitif, sans nouvelle tentative (vous pouvez la relancer manuellement). Tentative Délai après la précédente 1 Immédiate 2 ≈ 1 minute 3 ≈ 5 minutes 4 ≈ 30 minutes 5 ≈ 2 heures 6 ≈ 6 heures 7 ≈ 12 heures (dernière tentative, ≈ 21 h après l’événement) Après 20 livraisons consécutives en échec définitif, l'endpoint est désactivé automatiquement : le propriétaire du compte est prévenu par email et par un bandeau dans le dashboard. Corrigez votre serveur, puis réactivez l'endpoint depuis le dashboard ou avec `PATCH /webhook_endpoints/:id` et `"status": "active"`. L'historique des livraisons (statut, code HTTP, extrait de votre réponse, prochaine tentative) est conservé 30 jours. Une livraison peut être renvoyée depuis le dashboard (Renvoyer) ou avec `POST /webhook_deliveries/:id/retry` : cela crée une nouvelle livraison du même événement, avec le même `Strike-Event-Id`. ## Bonnes pratiques - Répondez vite : renvoyez `200` dès la signature vérifiée et l'événement mis en file, puis traitez-le de façon asynchrone. - Dédoublonnez sur `Strike-Event-Id` (et non sur `Strike-Delivery-Id`) : un même événement peut vous parvenir plus d'une fois (renvoi après un délai dépassé, renvoi manuel). - Ne supposez pas l'ordre : les événements peuvent arriver dans le désordre. Comparez `created_at`, ou relisez la ressource par l'API pour obtenir son état actuel. - Vérifiez toujours la signature et l'horodatage ; gardez le secret dans un gestionnaire de secrets. - Abonnez-vous au strict nécessaire : `event.tracked` peut représenter un très gros volume. - Surveillez l'historique des livraisons pour détecter un endpoint en difficulté avant sa désactivation. ## Tester en local STRIKE n'envoie qu'à des URL publiques. Pendant le développement, exposez votre serveur local avec un tunnel HTTPS (par exemple ngrok ou Cloudflare Tunnel), enregistrez l'URL du tunnel comme endpoint, puis utilisez le bouton Tester ou `POST /webhook_endpoints/:id/test` : le `ping` est envoyé immédiatement et la réponse de votre serveur vous est retournée. ## Action Webhook des parcours Indépendamment des abonnements ci-dessus, l'action Webhook du Journey Builder envoie une requête `POST` en JSON à l'URL de votre choix lorsqu'un lead atteint cette étape d'un parcours, par exemple pour créer une tâche dans votre CRM. Action Webhook d’un parcours ```http POST https://votre-outil.com/strike Content-Type: application/json User-Agent: StrikeSpace-Journeys/1.0 X-Strike-Delivery: { "type": "journey.action", "delivery_id": "", "lead": { "id": "…", "first_name": "Awa", "email": "awa@exemple.com", "phone_number": "+229…", "traits": { "plan": "pro" } }, "trigger": { … } } ``` - Répondez par un code 2xx en moins de 10 secondes. - Nouvelles tentatives : une réponse `5xx`, une `429` ou une erreur réseau entraîne de nouvelles tentatives avec un délai croissant ; une autre `4xx` est définitive. - Dédoublonnez avec l'en-tête `X-Strike-Delivery` (identique à `delivery_id`). - URL publique uniquement, en `http` ou `https`, sans redirection ; les adresses privées ou locales sont refusées. Les notifications des passerelles de paiement (FedaPay, CinetPay, Moneroo, Stripe) sont reçues directement par STRIKE : vous n'avez rien à configurer pour que vos paiements se mettent à jour. Abonnez-vous à `payment.succeeded` pour en être informé à votre tour. --- # Agents IA & MCP Source : https://strikespace.net/developpeurs/agents-ia Connectez Claude, ChatGPT, Cursor ou VS Code à votre compte STRIKE. Le Model Context Protocol (MCP) est le standard ouvert qui permet aux assistants IA d'utiliser des outils externes. Le serveur MCP de STRIKE donne à Claude, ChatGPT, Cursor, VS Code ou Claude Code un accès encadré à votre compte : « Quels leads chauds n'ont pas été relancés cette semaine ? », « Prépare trois publications Instagram pour la nouvelle collection »… URL du serveur MCP `https://strikespace.net/mcp` ## Comment ça marche - Vous ajoutez l'URL du serveur dans votre client IA. - Le client vous redirige vers STRIKE : vous vous connectez, choisissez les permissions accordées et approuvez. - L'agent reçoit un jeton de courte durée, limité à ces permissions et à votre compte. Il ne voit jamais votre mot de passe. - Vous suivez et révoquez les agents connectés dans Développeurs → Agents IA. Disponible pour les comptes Pro (20 agents connectés) et Enterprise (100). Tout membre de l'équipe peut connecter son propre agent ; celui-ci agit avec le rôle de la personne qui l'a approuvé. ## Claude (claude.ai et Claude Desktop) - Ouvrez Paramètres → Connecteurs, puis Ajouter un connecteur personnalisé. - Nom : `STRIKE` ; URL : `https://strikespace.net/mcp`. - Cliquez sur Se connecter : la page de consentement STRIKE s'ouvre. Vérifiez le compte et les permissions, puis approuvez. - Dans une conversation, activez le connecteur STRIKE depuis le menu des outils. Les connecteurs personnalisés dépendent de votre abonnement Claude ; sur les offres Team et Enterprise, un administrateur peut devoir les autoriser. ## ChatGPT - Ouvrez Paramètres → Connecteurs et activez le mode développeur dans les paramètres avancés. - Cliquez sur Créer : nom `STRIKE`, URL du serveur MCP `https://strikespace.net/mcp`, authentification OAuth. - Validez, puis connectez-vous à STRIKE et approuvez les permissions. - Sélectionnez le connecteur STRIKE dans une nouvelle conversation. La disponibilité des connecteurs personnalisés et du mode développeur dépend de votre offre ChatGPT et de votre espace de travail. ## Claude Code Terminal ```bash # Connexion OAuth (recommandé) : une page de consentement STRIKE s'ouvre claude mcp add --transport http strike https://strikespace.net/mcp # Puis, dans Claude Code : /mcp → strike → Authenticate ``` Ajoutez `--scope project` pour partager la configuration avec votre équipe via `.mcp.json` (chacun se connecte ensuite avec son propre compte), ou `--scope user` pour tous vos projets. ## Cursor Ajoutez le serveur dans `~/.cursor/mcp.json` (ou `.cursor/mcp.json` dans un projet), puis cliquez sur Connect dans Settings → MCP : ```json { "mcpServers": { "strike": { "url": "https://strikespace.net/mcp" } } } ``` ```json { "mcpServers": { "strike": { "url": "https://strikespace.net/mcp", "headers": { "Authorization": "Bearer ${env:STRIKE_API_KEY}" } } } } ``` ## VS Code (GitHub Copilot) Créez `.vscode/mcp.json` dans votre projet (ou utilisez la commande MCP: Add Server), puis démarrez le serveur et acceptez la connexion : ```json { "servers": { "strike": { "type": "http", "url": "https://strikespace.net/mcp" } } } ``` ```json { "inputs": [ { "type": "promptString", "id": "strike-key", "description": "Clé API STRIKE", "password": true } ], "servers": { "strike": { "type": "http", "url": "https://strikespace.net/mcp", "headers": { "Authorization": "Bearer ${input:strike-key}" } } } } ``` ## Autres clients et connexion par clé API Tout client compatible avec le transport Streamable HTTP peut se connecter. Si votre client ne gère pas OAuth, ou pour un agent qui tourne sur un serveur (automatisation, CI), utilisez une clé API dédiée, créée avec les seuls scopes nécessaires, dans l'en-tête `Authorization` : Client MCP générique ```json { "mcpServers": { "strike": { "type": "http", "url": "https://strikespace.net/mcp", "headers": { "Authorization": "Bearer sk_live_votre_cle" } } } } ``` Terminal ```bash # Variante avec une clé API (serveurs, CI, scripts) claude mcp add --transport http strike https://strikespace.net/mcp \ --header "Authorization: Bearer $STRIKE_API_KEY" ``` Une clé API placée dans un fichier de configuration est un secret : ne la versionnez pas, préférez une variable d'environnement, et créez une clé distincte par agent pour pouvoir la révoquer seule. ## Outils disponibles Les outils appellent exactement les mêmes services que l'API REST, avec les mêmes contrôles. Un outil n'est proposé à l'agent que si sa permission a été accordée : un agent en lecture seule ne voit aucun outil d'écriture. Outil Scope Rôle `get_workspace` — Compte, offre, scopes accordés et limites. `search_leads` `leads:read` Rechercher et filtrer les leads. `get_lead` `leads:read` Détail d’un lead. `upsert_lead` `leads:write` Créer ou mettre à jour un lead (par email / téléphone). `update_lead` `leads:write` Modifier un lead (statut, traits…). `track_event` `events:write` Enregistrer un événement pour un lead. `list_segments` `segments:read` Lister les segments. `get_segment_leads` `segments:read` Leads d’un segment. `list_funnels` `funnels:read` Lister les tunnels. `get_funnel` `funnels:read` Tunnel et statistiques. `list_campaigns` `campaigns:read` Lister les flux de relance. `enroll_in_campaign` sensible `campaigns:write` Inscrire un lead dans un flux (déclenche des envois). `list_journeys` `journeys:read` Lister les parcours. `enroll_in_journey` `journeys:write` Inscrire un lead dans un parcours actif. `list_brands` `social:read` Marques et comptes sociaux connectés. `get_brand_strategy` `social:read` Stratégie éditoriale d’une marque. `list_social_posts` `social:read` Publications par marque, statut, période. `create_social_post` `social:write` Créer un brouillon ou l’envoyer en validation. `schedule_social_post` sensible `social:publish` Planifier une publication. `list_payments` `payments:read` Ventes encaissées par les tunnels. `list_webhook_endpoints` sensible `webhooks:manage` Lister les endpoints de webhooks. ## Garde-fous - Vous choisissez les permissions sur la page de consentement. Les permissions sensibles (`campaigns:write`, `social:publish`, `webhooks:manage`) sont décochées par défaut. - Brouillons et validation : `create_social_post` crée un brouillon par défaut. Sans `social:publish`, l'agent ne peut rien publier ni planifier : il soumet au mieux à la validation de votre équipe. - Pas d'envoi caché : inscrire un lead dans un flux, qui déclenche de vrais messages, exige `campaigns:write`. - Rôle respecté : l'agent d'un membre de l'équipe a les droits de ce membre, pas ceux du propriétaire. - Confirmations côté client : les outils déclarent s'ils lisent (`readOnlyHint`) ou modifient des données, pour que votre client IA vous demande confirmation avant une écriture. - Révocation immédiate : Développeurs → Agents IA → Révoquer coupe l'accès de l'agent à l'instant ; ses jetons deviennent inutilisables. - Traçabilité : chaque appel d'un agent figure dans le Journal développeurs, avec le nom de l'agent. Un assistant IA peut se tromper ou mal interpréter une demande. Accordez le minimum de permissions, relisez les brouillons qu'il prépare, et gardez la validation humaine pour tout ce qui est envoyé ou publié. ## Détails techniques Transport Streamable HTTP, sans état : `POST https://strikespace.net/mcp` uniquement (`GET` et `DELETE` répondent `405`), réponses JSON. Authentification OAuth 2.1 (PKCE S256, enregistrement dynamique) ou clé API, en `Authorization: Bearer`. Voir [OAuth 2.1](https://strikespace.net/developpeurs/authentification#oauth). Découverte `https://strikespace.net/.well-known/oauth-protected-resource` (ressource `https://strikespace.net/mcp`) Origine L'en-tête `Origin`, s'il est présent, doit être celui de STRIKE (protection contre le DNS rebinding) : un site web tiers ne peut pas appeler le serveur depuis un navigateur. Limites Les mêmes que l'API REST : 60 requêtes par minute et par agent en Pro, 300 en Enterprise. ## Dépannage - « Offre requise » sur la page de consentement : l'API et les agents sont réservés aux offres Pro et Enterprise. - L'agent ne voit pas un outil : la permission correspondante n'a pas été accordée. Révoquez l'agent et reconnectez-le en cochant la permission. - Erreur 401 après quelques heures : votre client doit renouveler son jeton automatiquement ; sinon, reconnectez-le. - Erreur 403 `insufficient_scope` : l'action demandée dépasse les permissions accordées. --- # API de tracking (v1) Source : https://strikespace.net/developpeurs/tracking Événements, identification et création de leads avec la clé publique strk_. L'API de tracking reçoit les événements de votre site et de vos applications, identifie vos visiteurs et crée des leads. Elle s'authentifie avec votre clé de tracking publique `strk_…`, disponible dès l'offre Starter, et c'est elle qu'utilise le [SDK JavaScript](https://strikespace.net/developpeurs/sdk-javascript). Votre clé de tracking se trouve dans Engagement → Parcours, section Installer le tracking. Elle est publique et ne permet que l'écriture : elle peut figurer dans le code de votre site, mais ne donne accès à aucune donnée. Pour lire vos données ou agir depuis un serveur, utilisez l'[API REST](https://strikespace.net/developpeurs/api) (clé secrète `sk_live_`, offres Pro et Enterprise) et son endpoint [POST /events](https://strikespace.net/developpeurs/evenements). ## Principes Utilisez l'API directement depuis votre serveur, une application mobile ou un outil d'automatisation. Toutes les requêtes sont en JSON et s'authentifient avec l'en-tête `X-Strike-Key`. URL de base `https://strikespace.net/api/v1` En-têtes `Content-Type: application/json` et `X-Strike-Key: strk_…` Traitement Les endpoints de tracking valident la requête puis répondent `202 Accepted` ; l'enregistrement se fait de façon asynchrone, en général en quelques secondes. Débit 600 requêtes par minute et par clé. Au-delà, l'API répond `429 Too Many Requests` : patientez avant de renvoyer. CORS Les endpoints de tracking acceptent les appels depuis un navigateur. ## Envoyer un événement POST/api/v1/track Champ Type Description `event_name`requis string 1 à 128 caractères : lettres, chiffres, espaces, `_ . : -`. `anonymous_id` string Identifiant du visiteur non identifié (64 caractères max.). `anonymous_id` ou `lead_id` est requis. `lead_id` uuid Identifiant STRIKE d'un lead de votre compte. `properties` object Données libres de l'événement, 16 Ko maximum une fois sérialisées. `context` object Contexte technique (page, campagne…). L'IP et le user-agent sont ajoutés par le serveur. `timestamp` string Date ISO 8601 de l'action. Par défaut, l'heure de réception. Refusé s'il est plus de 24 h dans le futur. `message_id` string Identifiant unique de l'événement (64 caractères max.), utilisé pour dédoublonner les renvois. Généré si absent. curl ```curl curl -X POST https://strikespace.net/api/v1/track \ -H "Content-Type: application/json" \ -H "X-Strike-Key: strk_votre_cle" \ -d '{ "event_name": "order_paid", "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80", "properties": { "amount": 25000, "currency": "XOF" }, "message_id": "order-1042" }' ``` 202 Événement accepté : `{ "success": true, "message_id": "order-1042" }` 401 Clé absente ou invalide : `{ "error": "Clé de tracking (X-Strike-Key) invalide ou manquante." }` 422 Requête invalide : champ mal formé (liste `errors`), ou `{ "error": "…" }` si ni `lead_id` ni `anonymous_id`, propriétés > 16 Ko, ou horodatage invalide. ## Envoyer un lot d'événements POST/api/v1/batch Envoie de 1 à 100 événements en une requête. Chaque élément de `events` suit le même format que `/track`. C'est l'endpoint utilisé par le SDK. curl ```curl curl -X POST https://strikespace.net/api/v1/batch \ -H "Content-Type: application/json" \ -H "X-Strike-Key: strk_votre_cle" \ -d '{ "events": [ { "event_name": "page_view", "anonymous_id": "a1b2c3", "properties": { "path": "/offre" } }, { "event_name": "checkout_started", "anonymous_id": "a1b2c3", "properties": { "cart_total": 25000 } } ] }' ``` 202 `{ "success": true, "accepted": 2, "rejected": [] }`. Les événements inutilisables sont listés dans `rejected` avec leur position (`index`) et la raison (`error`) ; les autres sont enregistrés. 401 Clé absente ou invalide. 422 `events` vide, plus de 100 éléments, ou un élément mal formé : le lot entier est refusé. ## Identifier un visiteur POST/api/v1/identify Rattache un visiteur à un lead (existant ou nouveau) et met à jour ses informations. Au moins un champ parmi `lead_id`, `email` ou `phone_number` est requis. Champ Type Description `lead_id` uuid Lead existant de votre compte. `email` string Adresse email valide (254 caractères max.), enregistrée en minuscules. `phone_number` string Numéro de téléphone (32 caractères max.). Utilisez le format international : `+229…`. `first_name` string Prénom (120 caractères max.). `anonymous_id` string Identifiant anonyme à relier à ce lead (voir Identité des leads). `traits` object Attributs libres fusionnés dans les traits du lead, 16 Ko maximum. `message_id` string Identifiant unique de l'appel (64 caractères max.). curl ```curl curl -X POST https://strikespace.net/api/v1/identify \ -H "Content-Type: application/json" \ -H "X-Strike-Key: strk_votre_cle" \ -d '{ "anonymous_id": "a1b2c3", "email": "awa@exemple.com", "first_name": "Awa", "traits": { "plan": "pro", "city": "Cotonou" } }' ``` 202 `{ "success": true, "message_id": "…" }` 401 Clé absente ou invalide. 422 Champ mal formé, aucun identifiant fourni, ou `traits` > 16 Ko. ## Créer un lead POST/api/v1/leads Crée un lead dans votre compte et déclenche immédiatement son message de bienvenue. Utile pour connecter un formulaire externe ou un outil tiers. Le lead est compté dans votre quota mensuel. Champ Type Description `first_name`requis string Prénom, 2 à 100 caractères. `phone_number` string Format international strict, par exemple `+22997000000`. `phone_number` ou `email` est requis. `email` string Adresse email valide. `country_code` string Code pays ISO à 2 lettres. Par défaut `BJ`. `preferred_channel` string `whatsapp`, `email` ou `sms`. Par défaut : WhatsApp dans la zone UEMOA, email ailleurs. Le canal doit être inclus dans votre offre. Cet endpoint exige l'en-tête `X-Strike-Key` : le lead est rattaché au compte de la clé. Un éventuel champ `user_id` dans le corps de la requête est ignoré. curl ```curl curl -X POST https://strikespace.net/api/v1/leads \ -H "Content-Type: application/json" \ -H "X-Strike-Key: strk_votre_cle" \ -d '{ "first_name": "Kofi", "phone_number": "+22997000000", "country_code": "BJ", "preferred_channel": "whatsapp" }' ``` 201 Lead créé : `{ "success": true, "data": { "id", "first_name", "preferred_channel", "status": "cold" } }` 401 Clé absente ou invalide. 403 Quota mensuel de leads atteint, ou canal non inclus dans votre offre. 422 Champ invalide, ou ni téléphone ni email fourni. ## Identité des leads Un visiteur arrive d'abord anonymement sur votre site : le SDK lui attribue un `anonymous_id` stocké dans son navigateur, et tous ses événements y sont rattachés. Lorsqu'un appel `identify` contient cet `anonymous_id`, STRIKE cherche le lead correspondant dans cet ordre : - `lead_id`, s'il appartient à votre compte ; - l'adresse `email` ; - le numéro `phone_number` ; - un lien déjà établi pour cet `anonymous_id`. Si aucun lead n'est trouvé, un nouveau lead est créé, dans la limite de votre quota mensuel. L'identifiant anonyme est ensuite relié au lead : les événements passés du visiteur lui sont rattachés, ainsi que tous ses événements futurs. - Sur un lead existant, l'email et le téléphone ne sont complétés que s'ils étaient vides ; le prénom est mis à jour ; les traits sont fusionnés. - Un événement portant un `lead_id` qui n'appartient pas à votre compte est ignoré. - Appelez `strike.reset()` à la déconnexion pour qu'un autre utilisateur du même appareil ne soit pas confondu avec le précédent. ## Bonnes pratiques & limites 100 événements maximum par appel à `/batch` 16 Ko pour `properties` ou `traits`, une fois sérialisés 128 caractères maximum pour un nom d'événement 600 / min requêtes par clé de tracking, au-delà : réponse `429` - Nommez vos événements de façon stable, en `snake_case` et au passé ou à l'action : `checkout_started`, `order_paid`. Un segment se base sur le nom exact. - Fournissez un `message_id` côté serveur (identifiant de commande, de paiement…) : un même `message_id` n'est enregistré qu'une seule fois, vous pouvez donc renvoyer sans risque de doublon. - Préférez `/batch` dès que vous envoyez plusieurs événements à la fois. - Gérez les erreurs : une 4xx (hors 429) signale une requête à corriger, inutile de la renvoyer telle quelle ; une 5xx ou une 429 peut être renvoyée plus tard avec un délai croissant. - Identifiez le plus tôt possible, dès que le visiteur laisse un email ou un numéro : ses événements anonymes précédents lui seront rattachés. - N'envoyez pas de données sensibles (mots de passe, numéros de carte) dans `properties` ou `traits`. --- # SDK JavaScript Source : https://strikespace.net/developpeurs/sdk-javascript Le SDK navigateur de 3 Ko : track, identify, page, reset. Le SDK JavaScript envoie les événements de votre site à STRIKE et identifie vos visiteurs. Il pèse environ 3 Ko, n'a aucune dépendance et utilise votre clé de tracking publique `strk_…`. ## 1. Récupérez votre clé de tracking Dans votre dashboard, ouvrez Engagement → Parcours, puis la section Installer le tracking. Vous y trouverez votre clé (au format `strk_…`) et un snippet prêt à copier, déjà configuré pour votre compte. La clé de tracking est publique et ne permet que l'écriture : elle peut figurer dans le code de votre site. Elle ne donne accès à aucune donnée de votre compte. ## 2. Ajoutez le SDK à votre site Collez ce code avant la balise `` de chaque page : HTML ```html ``` Le SDK pèse environ 3 Ko, n'a aucune dépendance et enregistre automatiquement une vue de page (`page_view`) à l'initialisation. ## 3. Envoyez vos événements clés JavaScript ```js // Quand le visiteur laisse ses coordonnées strike.identify({ email: 'awa@exemple.com', first_name: 'Awa' }) // Quand il réalise une action importante strike.track('checkout_started', { cart_total: 25000, currency: 'XOF' }) ``` Vos événements apparaissent ensuite dans le constructeur de segments et peuvent déclencher un parcours dans le Journey Builder. ## Référence du SDK Le SDK expose un objet global `strike`. Les événements sont mis en file d'attente, conservés dans le `localStorage` du navigateur et envoyés par lots à `POST /api/v1/batch`. ## strike.init(key, options) Initialise le SDK. À appeler une fois par page, avant tout autre appel. Option Défaut Description `host` — URL de l'API STRIKE (celle indiquée dans votre snippet). `flushInterval` `2000` Délai en millisecondes avant l'envoi d'un lot d'événements. `autoPageView` `true` Envoie un événement `page_view` à l'initialisation. Passez `false` pour le désactiver. `leadId` — Identifiant STRIKE du lead, si vous le connaissez déjà (UUID). ## strike.identify(attributes) Associe le visiteur à un lead. Les clés `email`, `phone_number`, `first_name` et `lead_id` sont envoyées comme coordonnées ; toutes les autres clés sont enregistrées comme traits du lead. L'appel est envoyé immédiatement à `POST /api/v1/identify` et retourne une promesse. JavaScript ```js strike.identify({ email: 'awa@exemple.com', phone_number: '+22997000000', first_name: 'Awa', plan: 'pro', // → traits.plan city: 'Cotonou', // → traits.city }) ``` ## strike.track(eventName, properties) Enregistre une action du visiteur. Le nom est libre (lettres, chiffres, espaces et `_ . : -`, 128 caractères maximum). Les propriétés sont un objet JSON libre. JavaScript ```js strike.track('product_viewed', { product_id: 'robe-wax-42', price: 15000 }) strike.track('checkout_started', { cart: { total: 25000, items: 2 } }) ``` Chaque événement reçoit automatiquement un `anonymous_id`, un `message_id` unique, un horodatage et le contexte de la page (URL et titre). ## strike.page(properties) Envoie un événement `page_view` avec `url`, `path`, `title` et `referrer`, complétés par vos propriétés. Utile pour les applications monopages, à appeler à chaque changement de route. ## strike.reset() Oublie le visiteur courant (identifiant anonyme et lead mémorisé), par exemple à la déconnexion. Les événements suivants repartent d'un nouvel identifiant anonyme. ## strike.flush() Force l'envoi immédiat de la file d'attente. Le SDK envoie déjà la file automatiquement quand elle atteint 20 événements, après `flushInterval`, et quand l'onglet est masqué ou fermé. En cas d'erreur réseau, de réponse 5xx ou 429, le lot est conservé et renvoyé avec un délai croissant (de 2 à 60 secondes). Les autres erreurs 4xx ne seront jamais acceptées : le lot est alors abandonné pour ne pas bloquer la file. ## Applications monopages Sur une application monopage (React, Vue, Next.js…), désactivez au besoin `autoPageView` et appelez `strike.page()` à chaque changement de route : JavaScript ```js // Application monopage : une vue de page à chaque changement de route router.afterEach(() => strike.page({ section: 'boutique' })) // Déconnexion : oublier le visiteur courant strike.reset() ``` Le SDK s'appuie sur l'[API de tracking v1](https://strikespace.net/developpeurs/tracking) : consultez-la pour les formats, les limites et la façon dont les visiteurs anonymes sont rattachés à leurs leads. --- # Sécurité Source : https://strikespace.net/developpeurs/securite Comment STRIKE protège vos accès, et les bonnes pratiques de votre côté. Ouvrir votre compte à des intégrations et à des agents IA ne doit jamais affaiblir sa sécurité. Voici ce que STRIKE met en place, et ce que nous vous recommandons de faire de votre côté. ## Ce que fait STRIKE ### Identifiants - Clés et jetons jamais stockés en clair : seule une empreinte HMAC-SHA256 (avec une clé serveur) est enregistrée. Une fuite de la base de données seule ne révèle aucune clé utilisable. - Affichage unique : une clé API ou un secret de webhook n'est montré qu'à sa création. Le dashboard n'affiche ensuite qu'un extrait (`sk_live_AbCd…wxyz`). - Entropie élevée : 32 caractères aléatoires (≈ 190 bits) et un préfixe reconnaissable (`sk_live_`, `stk_at_`, `whsec_`) qui facilite la détection automatique des fuites. - Expiration, liste d'IP autorisées et révocation immédiate pour chaque clé. ### Permissions - Scopes et moindre privilège : chaque clé et chaque agent n'a accès qu'aux actions explicitement accordées ; les scopes d'envoi, de publication et de configuration ne sont jamais accordés par défaut. - Isolation des comptes : chaque requête est limitée aux données du compte de la clé ; un identifiant d'un autre compte répond `404`. - Rôles d'équipe respectés : seuls le propriétaire et les administrateurs créent des clés et des webhooks ; un agent agit avec le rôle de la personne qui l'a connecté. - Contrôle de l'offre à chaque appel : un compte qui repasse sous l'offre Pro perd l'accès API immédiatement. - Validation humaine : sans `social:publish`, aucune publication ne part sans l'approbation de votre équipe. ### OAuth 2.1 et agents IA - PKCE S256 obligatoire, correspondance exacte de l'URI de redirection, paramètre `state`, codes d'autorisation à usage unique valables 10 minutes. - Jetons de courte durée : 1 heure pour l'accès ; renouvellement avec rotation et détection de réutilisation (un refresh token rejoué révoque toute la connexion). - Liaison à la ressource (RFC 8707) : un jeton émis pour le serveur MCP n'est pas accepté par l'API REST, et inversement. - Page de consentement protégée contre le CSRF, affichant l'application, son domaine de redirection, le compte concerné et un avertissement pour les applications non vérifiées. - Protection du serveur MCP : validation de l'en-tête `Origin` contre le DNS rebinding ; enregistrement dynamique des clients limité par adresse IP. ### Transport, webhooks et surveillance - TLS pour toutes les communications ; webhooks envoyés uniquement en HTTPS en production. - Webhooks signés (HMAC-SHA256 horodaté) avec rotation du secret sans interruption. - Protection SSRF : les URL de webhooks sont résolues et vérifiées à chaque envoi ; adresses privées, locales et de métadonnées cloud refusées ; redirections non suivies ; délai maximal de 10 secondes. - Limites de débit par clé ou agent et par compte, contre les abus et les boucles accidentelles. - Journal d'audit : chaque appel (méthode, route, statut, durée, IP, identité de la clé ou de l'agent) est conservé 30 jours et consultable dans Développeurs → Journal. Les paramètres de requête et les corps n'y sont pas enregistrés. ## Ce que nous vous recommandons Stockez les secrets dans un gestionnaire de secrets (variables d'environnement chiffrées, Vault, AWS Secrets Manager, Doppler…), jamais dans le code source ni dans Git. Jamais de clé `sk_live_` côté client : ni dans un site web, ni dans une application mobile, ni dans une extension. Côté navigateur, utilisez uniquement la clé de tracking publique. Une clé par intégration, nommée clairement, avec les scopes minimaux : une révocation n'affecte alors qu'un seul service. Faites tourner vos clés régulièrement (au moins tous les 90 jours) et immédiatement en cas de doute, ou au départ d'un collaborateur ou d'un prestataire. Restreignez par adresse IP les clés utilisées depuis des serveurs aux adresses fixes, et donnez une date d'expiration aux clés temporaires. Vérifiez la signature et l'horodatage de chaque webhook avant de le traiter, avec une comparaison à temps constant. Surveillez le journal et la date de dernière utilisation de vos clés ; révoquez ce qui ne sert plus, y compris les agents IA inactifs. Encadrez les agents IA : n'accordez `social:publish` et `campaigns:write` qu'en connaissance de cause, et gardez la validation humaine pour les envois. ## En cas de fuite d'une clé - Révoquez immédiatement la clé dans Développeurs → Clés API (ou l'agent dans Agents IA). - Créez une nouvelle clé et déployez-la. - Consultez le Journal pour identifier les appels suspects (adresses IP, routes, horaires). - Si un secret de webhook est concerné, renouvelez-le. - Prévenez-nous si vous constatez un usage anormal : nous vous aiderons à l'analyser. ## Signaler une vulnérabilité Vous pensez avoir trouvé une faille de sécurité dans STRIKE ? Écrivez-nous à [contact@strike.app](mailto:contact@strike.app?subject=%5BS%C3%A9curit%C3%A9%5D%20Signalement%20de%20vuln%C3%A9rabilit%C3%A9) avec l'objet [Sécurité], en décrivant le problème, les étapes pour le reproduire et son impact potentiel. - Nous accusons réception rapidement et vous tenons informé de la correction. - Merci de ne pas divulguer publiquement la faille avant sa correction, de ne pas accéder aux données d'autres comptes que le vôtre et de ne pas dégrader le service (pas de test de charge ni d'attaque par déni de service). --- # Changelog Source : https://strikespace.net/developpeurs/changelog Les évolutions de la plateforme développeurs, version par version. Les évolutions de l'API, des webhooks et du serveur MCP. Les changements incompatibles sont toujours publiés dans une nouvelle version datée et annoncés à l'avance. ## Octobre 2026 — version 2026-10-01 Lancement Ouverture de la plateforme développeurs pour les offres Pro et Enterprise. - API REST privée `/api/platform/v1` : leads (dont upsert et effacement RGPD), événements, segments, tunnels, flux de relance, parcours, réseaux sociaux (marques, stratégie, publications avec validation), paiements et `GET /me`. - Clés API `sk_live_` avec 15 scopes, expiration, liste d'IP autorisées et journal d'audit de 30 jours. - Conventions : pagination par curseur, erreurs typées avec `request_id`, `Idempotency-Key`, en-têtes `RateLimit-*`. - Webhooks signés : 14 types d'événements, signature HMAC-SHA256 horodatée, rotation du secret sur 24 h, 7 tentatives sur ≈ 21 h, historique des livraisons et relance manuelle. - Serveur MCP `/mcp` pour les agents IA (Claude, ChatGPT, Cursor, VS Code, Claude Code) avec OAuth 2.1, PKCE, enregistrement dynamique des clients et 21 outils. - Spécification OpenAPI 3.1 publique et fichiers `/llms.txt` pour les agents. - Nouveau portail de documentation `/developpeurs`, qui remplace la page « API & SDK ». ## API de tracking v1 et SDK JavaScript L'API de tracking (`/api/v1/track`, `/batch`, `/identify`, `/leads`) et le SDK JavaScript restent disponibles sans changement, avec la clé publique `strk_`. Leur documentation se trouve désormais dans [API de tracking (v1)](https://strikespace.net/developpeurs/tracking) et [SDK JavaScript](https://strikespace.net/developpeurs/sdk-javascript).