Réseaux 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.
/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éé avecaction: "draft"(par défaut). Modifiable librement. - En validation (
pending_approval) : avecaction: "submit"ouPOST /social/posts/:id/submit. Les validateurs de votre équipe sont notifiés et approuvent depuis le dashboard. - Planifiée (
scheduled) : avec le scopesocial:publish,action: "schedule"ouPOST /social/posts/:id/schedule;POST /social/posts/:id/publishpublie immédiatement. - Publiée (
published, oupartially_publishedsi un réseau a échoué), ou en échec (failed) : à l'heure prévue, STRIKE publie sur chaque compte ciblé ; le détail est danstargets.
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
/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.
|
Exemple de requête
curl 'https://strikespace.net/api/platform/v1/brands' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// 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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/brands');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status >= 400) {
throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}
Réponse
{
"object": "list",
"data": [
{
"object": "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
/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 'https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// 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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10');
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": "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
not_found).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Stratégie éditoriale d’une marque
/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 'https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10/strategy' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// 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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/brands/8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10/strategy');
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": "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
not_found).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Équivalent pour les agents IA : l'outil MCP get_brand_strategy.
Lister les publications
/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.
|
Exemple de requête
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.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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/social/posts?brand_id=8e296a06-7a1e-4c2b-9f3d-5a6b7c8d9e10&status=scheduled');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status >= 400) {
throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}
Réponse
{
"object": "list",
"data": [
{
"object": "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
/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 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// 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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67');
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": "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
not_found).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Créer une publication
/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 -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.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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/social/posts');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
'Content-Type: application/json',
'Idempotency-Key: ' . bin2hex(random_bytes(16)),
],
CURLOPT_POSTFIELDS => json_encode([
'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.
{
"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
invalid_request) ; param indique le champ en cause.
not_found).
permission_error).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Équivalent pour les agents IA : l'outil MCP create_social_post.
Modifier une publication
/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 -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.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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => 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
{
"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
not_found).
conflict).
invalid_request) ; param indique le champ en cause.
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Envoyer en validation
/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 -X POST 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/submit' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// 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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/submit');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => 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
{
"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
not_found).
conflict).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Planifier une publication
/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 -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.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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/schedule');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => 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
{
"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
not_found).
invalid_request) ; param indique le champ en cause.
conflict).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Équivalent pour les agents IA : l'outil MCP schedule_social_post.
Publier immédiatement
/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 -X POST 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/publish' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// 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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67/publish');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => 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
{
"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
not_found).
conflict).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Supprimer un brouillon
/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 -X DELETE 'https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67' \
-H "Authorization: Bearer $STRIKE_API_KEY"
// 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)
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
$ch = curl_init('https://strikespace.net/api/platform/v1/social/posts/c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => 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
{
"object": "social_post",
"id": "c9f0f895-fb98-4b91-a0c8-3d2e1f4a5b67",
"deleted": true
}
Erreurs spécifiques
not_found).
conflict).
Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans
Conventions.
Une question sur l'intégration ? Écrivez à
contact@strike.app
en indiquant l'endpoint, l'heure et le request_id de la réponse.