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é
/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
{
"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
authentication_error).
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
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.