Clés API et authentification

Une clé API permet à votre propre code, aux SDK Posty5, à n8n et aux assistants IA de travailler avec votre compte Posty5. Cette page explique le fonctionnement des clés, et les autres pages développeurs donnent un lien vers elle au lieu de le répéter.

Obtenir un compte développeur

Les clés API sont une fonctionnalité du compte Développeur. Le passage à ce compte est gratuit et prend effet immédiatement. Il ne modifie ni votre forfait ni vos crédits.

Dans le tableau de bord Posty5, ouvrez Paramètres du compte et choisissez Clés API.
Choisissez Passer au compte développeur. La page se recharge et affiche vos clés API ainsi que les moyens de vous connecter à Posty5.

Ouvrez Clés API dans le tableau de bord

Créer une clé

Dans Clés API, choisissez Créer une clé API.
Donnez à la clé un nom qui indique où elle est utilisée, par exemple Formulaire de contact du site. Ce nom n’est visible que par vous.
Choisissez sa portée des enregistrements (expliquée plus bas), puis choisissez Créer. La nouvelle clé s’affiche avec un bouton de copie.

Une clé n’est pas affichée une seule fois. La liste affiche chaque clé masquée, et son bouton de copie recopie la clé entière chaque fois que vous en avez besoin. Renommez une clé ou modifiez la portée de ses enregistrements depuis ses actions dans la liste.

Envoyer la clé avec chaque requête

Envoyez la clé dans cet en-tête de chaque requête à l’API Posty5 —

L’API se trouve à l’adresse

Pour vérifier une clé, appelez la route qui la décrit. Elle renvoie la clé, son propriétaire, le forfait et les crédits que le compte peut dépenser. Une clé révoquée ou inconnue reçoit une erreur 401.

curl https://api.posty5.com/api/api-key/current \
  -H "X-API-Key: YOUR_API_KEY"

Les SDK et les nœuds n8n utilisent la même clé.

Client	Où placer la clé	En savoir plus
JavaScript / TypeScript	`new HttpClient({ apiKey: "YOUR_API_KEY" })`	npm-sdk
.NET	`new Posty5Options { ApiKey = "YOUR_API_KEY" }`	dotnet-sdk
n8n	L’identifiant Posty5 API, dans son champ API Key	n8n-nodes

Choisir ce qu’une clé peut voir

Chaque clé a une portée des enregistrements. Elle détermine quels enregistrements la clé peut lister et modifier.

Portée des enregistrements	Ce que la clé peut lister et modifier
Uniquement les enregistrements créés avec cette clé	Uniquement les enregistrements créés par cette clé. Ceux que vous avez créés dans le tableau de bord ou avec une autre clé restent hors de sa portée, si bien que deux intégrations ne touchent jamais au travail l’une de l’autre.
Tout mon compte	Tous les enregistrements de votre compte, quel que soit l’endroit où ils ont été créés. Un assistant IA en a généralement besoin, car vous l’interrogez sur des éléments que vous avez créés vous-même.

Une nouvelle clé démarre sur Uniquement les enregistrements créés avec cette clé, tout comme chaque clé créée avant l’existence de ce paramètre. Pour le modifier, ouvrez les actions de la clé et choisissez Modifier la portée des enregistrements. Le lien MCP d’une clé utilise la portée des enregistrements de cette clé.

Dernière utilisation et révocation d’une clé

La colonne Dernière utilisation indique quand la clé a envoyé sa dernière requête. Elle est mise à jour au plus une fois toutes les quelques minutes, donc une clé utilisée en continu peut sembler en retard de quelques minutes.

Pour révoquer une clé, ouvrez ses actions dans la liste, choisissez Révoquer et confirmez.

Elle cesse de fonctionner immédiatement. Chaque application, script et intégration qui l’utilise reçoit une erreur 401 à sa requête suivante.
Son lien d’assistant IA (MCP) s’arrête au même moment.
La révocation est irréversible. Créez une nouvelle clé si vous en avez de nouveau besoin.
Ce que la clé a déjà fait est conservé. Les enregistrements qu’elle a créés restent dans votre compte, et les publications qu’elle a programmées sont toujours publiées à l’heure, car la publication programmée n’utilise pas la clé.

Crédits

Un appel effectué avec une clé API coûte exactement autant que la même action dans le tableau de bord, et les crédits sont prélevés sur le compte propriétaire de la clé. Le prix de chaque action est indiqué sur Crédits des fonctionnalités

Protéger vos clés

Conservez les clés sur un serveur. N’en placez jamais une dans une page web, une application mobile ou un dépôt public , toute personne qui la lit peut agir en votre nom.
Une clé ne peut pas gérer les clés. Créer, lister, renommer et révoquer des clés ne fonctionne que lorsque vous êtes connecté à Posty5 , une clé divulguée ne peut donc ni lire vos autres clés ni en créer de nouvelles.
Pour renouveler une clé, créez-en une nouvelle, basculez votre intégration dessus, vérifiez que la date de Dernière utilisation de la nouvelle clé change, puis révoquez l’ancienne clé.
Si une clé fuite, révoquez-la immédiatement et créez-en une nouvelle.