Naar inhoud springen

n8n verbinden met een persoonlijke API-sleutel

De communitynode n8n-nodes-marcomm schrijft persberichten, blogberichten, persevenementen en RSVP-uitnodigingen, legt ze ter goedkeuring voor en publiceert ze. Het pakket is nog niet gepubliceerd.

  1. 1
    Ga in Marcomm naar Instellingen → Integraties → n8n om de status en de benodigde waarden te zien.
    Instellingen, Integraties, n8n, met de status, de verbindingsstappen, de aan te vinken scopes en de status van de API-toegang
    De pagina van n8n toont de huidige status, de stappen, de waarden om te kopiëren en of API-toegang voor deze werkruimte is goedgekeurd.
  2. 2
    Open Instellingen → API. Heeft de werkruimte nog geen API-toegang, dan vult een eigenaar of beheerder API-toegang aanvragen in en kiest Aanvraag indienen.
  3. 3
    Open na goedkeuring Sleutel maken, kies Persoonlijke sleutel, vink de nodige Scopes aan en kies Sleutel maken. Kopieer de sleutel meteen, want hij wordt maar één keer getoond.
  4. 4
    Zoek in n8n Cloud in het nodepaneel naar Marcomm AI (verschijnt hij niet, zet dan Verified Community Nodes aan in het beheerpaneel en start de instantie opnieuw). Open in een zelf gehoste n8n Settings (Instellingen), dan Community Nodes, dan Install (Installeren), en vul n8n-nodes-marcomm in.
  5. 5
    Maak een credential Marcomm AI API, plak de sleutel bij API Key (API-sleutel) en voeg de node Marcomm AI of Marcomm AI Trigger toe aan een workflow.

De triggernode heeft de scope Content nodig en verstuurt niets bij de eerste controle, zodat oudere items niet opnieuw afgaan.

De node dekt persberichten, blogberichten, persevenementen, RSVP-uitnodigingen en goedkeuringen, inclusief goedkeuren, afwijzen en de lijst met openstaande goedkeuringen. De triggernode start een workflow wanneer een persbericht wordt gemaakt, ter goedkeuring wordt voorgelegd of wordt gepubliceerd, wanneer een blogbericht wordt gemaakt of gepubliceerd, of wanneer een persevenement wordt gemaakt.

Scopes bepalen wat een sleutel mag. Content (content) leest persberichten, blogberichten en persevenementen, Inhoud schrijven (content:write) maakt en bewerkt concepten, Publiceren en versturen (distribution) publiceert en verstuurt per e-mail, en Goedkeuringen (approvals) dekt goedkeuringsstappen. De laatste drie werken alleen met een Persoonlijke sleutel, omdat de actie wordt vastgelegd op naam van wie de sleutel heeft gemaakt. Een Werkruimtesleutel kan alleen lezen, en elke sleutel werkt met de rol en rechten van wie hem heeft gemaakt.

Publiceren en versturen zijn onomkeerbaar. De API voert ze alleen uit als het verzoek confirm: true of een Idempotency-Key-header bevat, en publiceert niets en antwoordt met 409 zolang goedkeuring nog nodig is of het item gepland of onder embargo is. Een nieuwe poging met dezelfde Idempotency-Key en hetzelfde verzoek geeft 24 uur lang het eerste resultaat terug in plaats van opnieuw te draaien. De node stuurt bij elke schrijfactie een idempotentiesleutel mee die is gemaakt uit de uitvoering, de node en het item, en bevestigt publiceren en versturen zelf.

De API is beschikbaar vanaf het Team-abonnement. Het team van Marcomm AI beoordeelt elke aanvraag, en sleutels werken pas na goedkeuring. Een sleutel kan alleen de scopes gebruiken die voor de werkruimte zijn goedgekeurd, en iedereen kan tot 10 sleutels hebben. Standaard kan een werkruimte 60 verzoeken per minuut en 10.000 per dag doen; daarboven antwoordt de API met 429 en een Retry-After-header. Gebruik Hogere limieten nodig? in Instellingen → API om de limieten te verhogen. Kies Intrekken naast de sleutel om n8n los te koppelen; systemen die hem gebruiken verliezen meteen de toegang.

Veelgestelde vragen

Roep GET https://marcomm.works/api/v1/me aan met de header Authorization: Bearer gevolgd door uw sleutel. Dat werkt met elke goedgekeurde sleutel, welke scopes hij ook heeft, en geeft de werkruimte, de naam van de sleutel en de scopes terug.

Een sleutel legt niet vast welke dienst hem gebruikt, dus Marcomm markeert de kaart van n8n niet als verbonden. In Instellingen → API ziet u wanneer elke sleutel voor het laatst is gebruikt.

Ja, met de ingebouwde node HTTP Request. Roep https://marcomm.works/api/v1 aan met de header Authorization: Bearer gevolgd door uw sleutel en voeg aan elke schrijfactie een Idempotency-Key-header toe.

Integraties