Comment créer une clé API
|Une clé API MagicPost permet à un assistant IA ou à votre propre code d'agir sur votre compte MagicPost. Vous créez une clé dans l'application : ouvrez le menu de profil, sélectionnez Paramètres, puis ouvrez l'onglet API & MCP. Les clés API sont incluses dans les plans Creator, Agency et Team et pendant l'essai gratuit MagicPost. Le plan Growth n'inclut pas les clés API.
Vous créez une clé API MagicPost pour appeler l'API REST MagicPost, ainsi que pour les trois assistants que l'application MagicPost configure avec une clé : Claude Desktop, Claude Code et Perplexity. Claude Code peut également se connecter par une authentification MagicPost, sans clé. Vous ne créez pas de clé pour Claude sur le web, ChatGPT ou Gemini. Ces trois assistants se connectent par une authentification MagicPost, et MagicPost crée la clé pour vous lorsque vous approuvez la connexion.
Qui peut créer une clé API MagicPost
Creator, Agency et Team. Les clés API et le serveur MCP MagicPost font partie de ces plans.
Essai gratuit. Les clés API sont disponibles pendant toute la durée de l'essai gratuit MagicPost. Une clé cesse de fonctionner lorsque l'essai se termine sans abonnement à l'un de ces plans.
Membres d'une organisation. Un membre d'une organisation Agency ou Team peut créer des clés API MagicPost. Il existe une exception avec Agency, où les sièges ont différents types : un siège Growth, Analytics ou Engagement n'inclut pas les clés API. Le siège Creator, qui dispose d'un accès complet, les inclut.
Growth. Le plan Growth n'inclut pas les clés API, et MagicPost n'affiche pas l'onglet API & MCP aux abonnés du plan Growth.
Un abonnement à un ancien plan MagicPost suit ses propres règles : consultez Les plans Analytics et Starter. Pour passer à un plan qui inclut les clés API, consultez comment mettre à niveau votre plan MagicPost.
Comment créer une clé API MagicPost
Dans MagicPost, ouvrez le menu de profil et sélectionnez Paramètres.
Ouvrez l'onglet API & MCP. Le lien direct est app.magicpost.in/settings?tab=api-keys.
Cliquez sur Créer une clé. Lorsque la liste des clés est vide, le bouton de la liste affiche Créer ta première clé.
Dans la fenêtre Créer une clé API, renseignez le champ Nom de la clé avec le nom de l'outil auquel vous vous connectez, par exemple « Claude Desktop ». Le nom est obligatoire.
Cliquez sur Créer. La fenêtre Clé API créée affiche la clé.
Cliquez sur Copier à côté de la clé et conservez-la dans un endroit sûr.
Cliquez sur J'ai copié, fermer.
Une clé API MagicPost commence par mp_. MagicPost affiche la clé complète une seule fois, dans la fenêtre Clé API créée. MagicPost conserve un hachage de la clé, et non la clé elle-même, afin que personne ne puisse l'afficher à nouveau ultérieurement. Si vous fermez la fenêtre sans copier la clé, créez-en une nouvelle.
Ce que vous fournit la fenêtre « Clé API créée »
Sous la clé, la fenêtre MagicPost Clé API créée comporte un onglet pour chaque assistant, avec les éléments à coller et leur emplacement :
Claude Desktop : un bloc de configuration contenant déjà votre clé, à coller dans le fichier claude_desktop_config.json.
Claude Code : une commande contenant déjà votre clé, à exécuter dans votre terminal. Claude Code peut également se connecter sans clé, par une authentification MagicPost : la page Claude Code de la documentation développeur MagicPost décrit cette méthode.
Perplexity : l'adresse du serveur MCP MagicPost, à ajouter comme connecteur personnalisé avec une authentification par clé API.
Claude Web, ChatGPT et Gemini : l'adresse du serveur MCP MagicPost uniquement, car ces assistants n'ont pas besoin de clé.
La configuration de chaque assistant est présentée dans Comment connecter MagicPost à Claude, ChatGPT, Gemini et Perplexity. Les actions possibles dans MagicPost avec un assistant connecté sont décrites dans Qu'est-ce que MCP et que puis-je faire avec ? Pour une présentation du produit, consultez la page de présentation de la fonctionnalité LinkedIn MCP.
Comment gérer et révoquer vos clés API MagicPost
La liste Tes clés de l'onglet API & MCP affiche chaque clé API MagicPost active avec son nom, ses premiers caractères, sa date de création et la date de sa dernière utilisation. La liste n'affiche jamais une clé complète.
Les clés API MagicPost créées lors d'une connexion depuis Claude sur le web, ChatGPT ou Gemini apparaissent dans la même liste, sous le nom donné par l'assistant lors de sa connexion.
Pour révoquer une clé API MagicPost, cliquez sur l'icône de corbeille de sa ligne, puis cliquez sur Révoquer dans la fenêtre Révoquer cette clé API ?. L'API MagicPost vérifie la clé à chaque requête : une clé révoquée cesse donc de fonctionner immédiatement. La révocation est définitive : une clé révoquée ne peut pas être réactivée. Les clés révoquées restent visibles dans une section réduite sous la liste.
Une clé API MagicPost n'expire pas. Elle fonctionne jusqu'à ce que vous la révoquiez ou que le compte MagicPost perde l'accès à l'API.
MagicPost limite le nombre de clés API actives sur un même compte. L'application MagicPost compte chaque clé active de la liste Tes clés, y compris les clés créées lors d'une connexion depuis Claude sur le web, ChatGPT ou Gemini. Lorsque vous atteignez la limite, Créer une clé est désactivé et l'onglet API & MCP affiche le maximum autorisé. Révoquez une clé ou une connexion d'assistant que vous n'utilisez plus pour créer une nouvelle clé.
La limite MagicPost de clés API actives bloque uniquement Créer une clé dans l'application. Une connexion depuis Claude sur le web, ChatGPT ou Gemini reste acceptée lorsque le compte a atteint la limite, et la clé de cette connexion s'ajoute à la liste Tes clés.
À quoi donne accès une clé API MagicPost
Une clé API MagicPost donne accès à l'ensemble de votre compte, et non à une partie seulement. Avec votre clé, un outil peut lire vos brouillons et vos métriques LinkedIn, créer et planifier des posts, publier sur votre compte LinkedIn et utiliser vos crédits Leads. Gardez la clé secrète et créez une clé par outil afin de pouvoir en révoquer une sans interrompre les autres.
Dans une organisation Agency ou Team, une clé créée depuis le compte d'un administrateur donne également accès aux comptes des membres : elle peut les lister, consulter leurs métriques et leurs posts, et créer et planifier des posts pour eux.
Une agence n'a pas besoin d'une clé API MagicPost par client. Une clé créée depuis le compte d'un membre qui n'est pas administrateur est limitée au compte de ce membre.
Comment utiliser une clé API MagicPost avec l'API REST
Pour appeler l'API REST MagicPost, envoyez la clé dans l'en-tête Authorization en tant que jeton bearer : le mot Bearer, un espace, puis votre clé. L'adresse de base de l'API est https://api.magicpost.in/api/v1/. La référence de l'API se trouve dans la documentation développeur MagicPost. Elle couvre les clés API, les métriques, les posts et la planification.
Une clé API MagicPost seule ne permet pas d'importer un fichier multimédia dans un post via l'API REST : seul le serveur MCP MagicPost joint un fichier à un brouillon. Un appel REST direct peut toutefois modifier le titre et le texte alternatif d'un fichier multimédia déjà joint.
L'API MagicPost limite le nombre de requêtes par minute pour chaque clé. L'actualisation des posts LinkedIn et la détection de leads sont soumises à une limite par minute plus stricte. La publication et la planification d'un post ont leur propre limite par minute. La génération de posts a ses propres limites par minute, par jour et par semaine. En cas de dépassement d'une limite, l'API MagicPost répond avec le statut HTTP 429 et la réponse indique la limite qui s'applique.
La documentation développeur MagicPost indique les valeurs à deux endroits. La page des erreurs et des limites de débit indique la limite par minute par défaut et la limite d'actualisation des posts. L'entrée generate_post de la page des outils indique les limites de génération de posts.
MagicPost limite également le nombre de posts qu'un profil LinkedIn peut publier sur une période de 24 heures ; les posts planifiés sont également comptabilisés. En cas de dépassement de cette limite, l'API MagicPost refuse de publier ou de planifier avec le statut HTTP 429, et la réponse indique la limite ainsi que le prochain créneau disponible. La limite dépend du compte.
FAQ
J'ai perdu ma clé API MagicPost. Puis-je l'afficher à nouveau ?
Non. MagicPost n'affiche une clé API qu'une seule fois, lors de sa création, et ne conserve qu'un hachage de celle-ci. Révoquez la clé perdue dans Paramètres, API & MCP, puis créez une nouvelle clé et remplacez-la dans votre outil.
Pourquoi l'onglet API & MCP n'apparaît-il pas dans mes paramètres MagicPost ?
MagicPost masque l'onglet API & MCP dans deux cas : vous êtes sur le plan Growth, ou vous êtes membre d'une organisation Agency avec un siège Growth, Analytics ou Engagement. Les clés API sont incluses dans les plans Creator, Agency et Team. Sur un compte gratuit dont l'essai est terminé, l'onglet est visible, mais Créer une clé ouvre une fenêtre de mise à niveau.
Ai-je besoin d'une clé API MagicPost par client ou par membre de l'équipe ?
Non. Dans une organisation Agency ou Team, une clé créée depuis le compte d'un administrateur donne accès aux comptes de tous les membres. Si vous préférez une clé par membre, créez-la depuis les paramètres du compte de ce membre.
Une connexion depuis ChatGPT, Gemini ou Claude sur le web crée-t-elle une clé ?
Oui. Lorsque vous approuvez la connexion sur la page d'autorisation MagicPost, MagicPost crée une clé API portant le nom donné par l'assistant. MagicPost répertorie cette clé dans l'onglet API & MCP, et sa révocation déconnecte l'assistant. Lorsqu'un connecteur déjà connu de MagicPost se reconnecte, MagicPost révoque la clé qu'il utilisait et en crée une nouvelle.
Ma clé API MagicPost a cessé de fonctionner. Pourquoi ?
Il y a deux raisons courantes. La clé a été révoquée dans l'onglet API & MCP. Ou le compte n'a plus accès à l'API, par exemple après la fin de l'essai gratuit ou après un changement vers un plan sans clés API. Dans le second cas, l'API MagicPost indique que l'accès à l'API et au MCP n'est pas inclus dans votre plan.
Besoin d'aide ?
Contactez-nous via le chat intégré à l'application ou réservez un appel d'onboarding de 30 minutes : https://cal.com/magicpost-team/planifier-un-appel