Passer au contenu principal

​
Authentification par clé d’API

Les requêtes de l’API REST utilisent une clé d’API transmise dans l’en-tête X-API-Key. Les clients MCP peuvent utiliser une clé d’API ou un OAuth avec PKCE approuvé par l’utilisateur. Les agents IA peuvent commencer par Auth.md pour la découverte OAuth, l’enregistrement du client, le consentement de l’utilisateur, l’actualisation des jetons et la création d’une clé d’API pour la CLI.

​
Générer une clé d’API

1

Connectez-vous à votre tableau de bord

Rendez-vous sur Social media studio et connectez-vous.
2

Ouvrez les paramètres de l'API

Allez dans Paramètres > onglet API.
3

Créez une nouvelle clé

Cliquez sur Nouvelle clé API et donnez-lui un nom.
4

Choisissez l'accès

Gardez Accès complet, ou sélectionnez Restreint et définissez chaque ressource sur Aucun accès, Lecture ou Lecture et écriture. Voir Scopes.
5

Copiez la clé

Cliquez sur Créer et copiez la clé.
La clé complète n’est affichée qu’une seule fois. Conservez-la en lieu sûr. Si vous la perdez, révoquez-la et créez-en une nouvelle.

​
Autorisations

Seuls les propriétaires de l’espace de travail peuvent créer, lister et révoquer des clés d’API. Une clé agit au nom de l’espace de travail dans lequel elle a été créée, et uniquement sur les données de cet espace de travail. Si un propriétaire quitte l’espace de travail ou que ses accès changent, révoquez et recréez les clés qu’il avait créées.

​
Scopes

Une clé a un accès complet, sauf si vous lui donnez des scopes lors de sa création. Toutes les clés créées avant l’existence des scopes conservent un accès complet. Une clé limitée à certains scopes ne peut appeler que les endpoints couverts par ses scopes. Tout autre endpoint renvoie 403 Forbidden, avec le scope manquant dans le message.
  • Un endpoint GET exige <resource>:read.
  • Un endpoint POST, PUT, PATCH ou DELETE exige <resource>:write.
  • <resource>:write inclut <resource>:read.
Exceptions :
  • POST /v1/media/validate n’exige que media:read, car il ne modifie rien.
  • POST /v1/templates/{id}/render n’exige que templates:read.
  • Ces endpoints exigent une clé à accès complet : PATCH /v1/settings/profile, tout /v1/settings/api-keys et tout /v1/settings/tenants. Une clé limitée à certains scopes ne peut ni créer de nouvelle clé ni accéder à d’autres espaces de travail.
  • Le serveur MCP n’accepte pas les clés limitées à certains scopes. Utilisez une clé à accès complet ou connectez-vous avec OAuth.
  • teams:write ne permet pas d’inviter ou de promouvoir des propriétaires. Seule une clé à accès complet peut attribuer le rôle owner.
  • Une clé limitée à certains scopes ne peut s’abonner qu’aux événements webhook qu’elle peut lire, les lister et les relancer. Par exemple, les événements inbox exigent inbox:read, et les événements post, draft et approval exigent posts:read. Les événements knowledge, organization, account, auth, api_key, integration, subscription, referral, mcp et quota exigent une clé à accès complet.
Pour créer une clé limitée à certains scopes via l’API, envoyez scopes à POST /v1/settings/api-keys avec une clé à accès complet :
Omettez scopes pour obtenir une clé à accès complet. Vous ne pouvez pas modifier les scopes d’une clé : révoquez-la et créez-en une nouvelle.

​
Utiliser votre clé d’API

​
API REST

Transmettez la clé dans l’en-tête X-API-Key :

​
Serveur MCP

Le serveur MCP utilise la même clé d’API. Il n’accepte que les clés à accès complet. Transmettez la clé dans l’en-tête X-API-Key de votre configuration MCP :

​
Forfaits requis

L’accès à l’API REST, à la CLI et au MCP est disponible avec les forfaits Standard, Advanced et Lifetime. Le forfait Lite n’inclut pas l’accès à l’API, à la CLI ni au MCP. Pour le détail complet des forfaits, consultez la présentation de la facturation.

​
Limitation de débit

Les requêtes API sont limitées par espace de travail, la limite exacte dépendant de votre forfait. Lorsque vous dépassez la limite, vous recevez une réponse 429 Too Many Requests : attendez la réinitialisation de la fenêtre, puis réessayez. Les appels d’outils MCP consomment également des crédits selon votre forfait. Consultez votre utilisation dans Paramètres > API, et reportez-vous à Crédits IA pour comprendre leur fonctionnement.
Les forfaits supérieurs bénéficient de limites de débit et de quotas d’utilisation mensuelle de l’API plus élevés. Consultez la présentation de la facturation pour les limites applicables à votre forfait.