Connecter n8n avec une clé d'API personnelle
Le nœud communautaire n8n-nodes-marcomm rédige des communiqués de presse, des articles de blog, des événements presse et des invitations RSVP, les soumet à validation et les publie. Le paquet n'est pas encore publié.
- 1Dans Marcomm, ouvrez Paramètres → Intégrations → n8n pour voir l'état et les valeurs nécessaires.

La page n8n affiche l'état actuel, les étapes, les valeurs à copier et indique si l'accès à l'API est approuvé pour cet espace de travail. - 2Ouvrez Paramètres → API. Si l'espace de travail n'a pas encore d'accès à l'API, un propriétaire ou un admin remplit Demander l'accès à l'API et sélectionne Envoyer la demande.
- 3Après l'approbation, ouvrez Créer une clé, choisissez Clé personnelle, cochez les Portées nécessaires et sélectionnez Créer la clé. Copiez la clé tout de suite, elle n'est affichée qu'une fois.
- 4Dans n8n Cloud, recherchez Marcomm AI dans le panneau des nœuds (s'il n'apparaît pas, activez Verified Community Nodes dans le panneau d'administration et redémarrez l'instance). Dans un n8n auto-hébergé, ouvrez Settings (Paramètres), puis Community Nodes, puis Install (Installer), et saisissez
n8n-nodes-marcomm. - 5Créez un identifiant Marcomm AI API, collez la clé dans API Key (clé d'API), puis ajoutez le nœud Marcomm AI ou Marcomm AI Trigger à un workflow.
Le nœud déclencheur a besoin de la portée Contenu et n'envoie rien lors de sa première vérification, pour ne pas renvoyer d'anciens éléments.
Le nœud couvre les communiqués de presse, les articles de blog, les événements presse, les invitations RSVP et les validations, y compris valider, refuser et la liste des validations en attente. Le nœud déclencheur lance un workflow quand un communiqué de presse est créé, soumis à validation ou publié, quand un article de blog est créé ou publié, ou quand un événement presse est créé.
Les portées définissent ce qu'une clé peut faire. Contenu (content) lit les communiqués de presse, les articles de blog et les événements presse, Écrire du contenu (content:write) crée et modifie des brouillons, Publier et envoyer (distribution) publie et envoie par e-mail, et Validations (approvals) couvre les étapes de validation. Les trois dernières ne fonctionnent qu'avec une Clé personnelle, car l'action est enregistrée au nom de la personne qui a créé la clé. Une Clé d'espace de travail ne fait que lire, et chaque clé agit avec le rôle et les droits de la personne qui l'a créée.
La publication et l'envoi sont irréversibles. L'API ne les exécute que si la requête contient confirm: true ou un en-tête Idempotency-Key, et elle ne publie rien et répond 409 tant qu'une validation est requise ou que le contenu est programmé ou sous embargo. Une nouvelle tentative avec le même Idempotency-Key et la même requête renvoie le premier résultat pendant 24 heures au lieu de s'exécuter à nouveau. Le nœud envoie une clé d'idempotence à chaque écriture, construite à partir de l'exécution, du nœud et de l'élément, et confirme lui-même la publication et l'envoi.
L'API est disponible à partir du forfait Team. L'équipe de Marcomm AI examine chaque demande, et les clés ne fonctionnent qu'après l'approbation. Une clé ne peut utiliser que les portées approuvées pour l'espace de travail, et chaque personne peut avoir jusqu'à 10 clés. Par défaut, un espace de travail peut faire 60 requêtes par minute et 10 000 par jour ; au-delà, l'API répond 429 avec un en-tête Retry-After. Pour relever les limites, utilisez Besoin de limites plus élevées ? dans Paramètres → API. Pour déconnecter n8n, sélectionnez Révoquer à côté de la clé ; les systèmes qui l'utilisent perdent l'accès aussitôt.
FAQ
Appelez
GET https://marcomm.works/api/v1/meavec l'en-têteAuthorization: Bearersuivi de votre clé. Cela fonctionne avec toute clé approuvée, quelles que soient ses portées, et renvoie l'espace de travail, le nom de la clé et ses portées.Une clé n'enregistre pas le service qui l'utilise, donc Marcomm ne marque pas la carte n8n comme connectée. Paramètres → API indique quand chaque clé a été utilisée pour la dernière fois.
Oui, avec le nœud intégré HTTP Request. Appelez
https://marcomm.works/api/v1avec l'en-têteAuthorization: Bearersuivi de votre clé, et ajoutez un en-têteIdempotency-Keyà chaque écriture.