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.

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é.

  1. Brouillon (draft) : créé avec action: "draft" (par défaut). Modifiable librement.
  2. 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.
  3. Planifiée (scheduled) : avec le scope social:publish, action: "schedule" ou POST /social/posts/:id/schedule ; POST /social/posts/:id/publish publie immédiatement.
  4. 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.

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

Réponse 200
{
  "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 '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

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

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 '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

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

É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.

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

Réponse 200
{
  "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 '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

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

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 -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.

Réponse 201
{
  "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.

É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 -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

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

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 -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

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

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 -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

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

É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 -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

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

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 -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

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

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