Référence de l’API REST

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
Format JSON, snake_case, pagination par curseur — voir 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

curl 'https://strikespace.net/api/platform/v1/openapi.json'
// 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)
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/openapi.json",
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/openapi.json');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => 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 'https://strikespace.net/api/platform/v1/me' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// 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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/me');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

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

Réponse

Réponse 200
{
  "object": "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.

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

Tous les endpoints

Leads

GET /leads Lister les leads leads:read
GET /leads/:id Récupérer un lead leads:read
POST /leads Créer ou mettre à jour un lead leads:write
PATCH /leads/:id Modifier un lead leads:write
DELETE /leads/:id Supprimer un lead (RGPD) leads:write
GET /leads/:id/events Événements d’un lead events:read

Événements

POST /events Envoyer un événement events:write
GET /events Lister les événements events:read

Segments

GET /segments Lister les segments segments:read
GET /segments/:id Récupérer un segment segments:read
GET /segments/:id/leads Leads d’un segment segments:read

Tunnels

GET /funnels Lister les tunnels funnels:read
GET /funnels/:id Récupérer un tunnel et ses statistiques funnels:read

Flux de relance

GET /campaigns Lister les flux campaigns:read
GET /campaigns/:id Récupérer un flux campaigns:read
POST /campaigns/:id/enrollments Inscrire un lead dans un flux campaigns:write

Parcours

GET /journeys Lister les parcours journeys:read
GET /journeys/:id Récupérer un parcours journeys:read
POST /journeys/:id/enrollments Inscrire un lead dans un parcours journeys:write

Réseaux sociaux

GET /brands Lister les marques social:read
GET /brands/:id Récupérer une marque social:read
GET /brands/:id/strategy Stratégie éditoriale d’une marque social:read
GET /social/posts Lister les publications social:read
GET /social/posts/:id Récupérer une publication social:read
POST /social/posts Créer une publication social:write
PATCH /social/posts/:id Modifier une publication social:write
POST /social/posts/:id/submit Envoyer en validation social:write
POST /social/posts/:id/schedule Planifier une publication social:publish
POST /social/posts/:id/publish Publier immédiatement social:publish
DELETE /social/posts/:id Supprimer un brouillon social:write

Paiements

GET /payments Lister les paiements payments:read

Endpoints de webhooks

GET /webhook_endpoints Lister les endpoints webhooks:manage
POST /webhook_endpoints Créer un endpoint webhooks:manage
GET /webhook_endpoints/:id Récupérer un endpoint webhooks:manage
PATCH /webhook_endpoints/:id Modifier un endpoint webhooks:manage
DELETE /webhook_endpoints/:id Supprimer un endpoint webhooks:manage
POST /webhook_endpoints/:id/rotate_secret Renouveler le secret webhooks:manage
POST /webhook_endpoints/:id/test Envoyer un événement de test webhooks:manage
GET /webhook_endpoints/:id/deliveries Historique des livraisons webhooks:manage
POST /webhook_deliveries/:id/retry Renvoyer une livraison webhooks:manage

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