Make verbinden met de HTTP-module
De Marcomm AI-app voor Make is in beoordeling. Roep tot de goedkeuring de API van Marcomm AI aan vanuit een Make-scenario met de HTTP-module en een persoonlijke API-sleutel.
- 1Ga in Marcomm naar Instellingen → Integraties → Make om de status en de benodigde waarden te zien.

De pagina van Make toont de huidige status, de stappen, de waarden om te kopiëren en of API-toegang voor deze werkruimte is goedgekeurd. - 2Open Instellingen → API. Heeft de werkruimte nog geen API-toegang, dan vult een eigenaar of beheerder API-toegang aanvragen in en kiest Aanvraag indienen.
- 3Open 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.
- 4Voeg in een Make-scenario de module HTTP toe en kies Make a request.
- 5Vul een endpoint uit de ontwikkelaarsdocumentatie in na
https://marcomm.works/api/v1en voeg de headerAuthorizationtoe metBearergevolgd door uw sleutel.
Begin met GET /me om de sleutel te controleren voordat u de rest van het scenario bouwt.
De Marcomm AI-app voor Make is in beoordeling en kan nog niet worden toegevoegd. Na goedkeuring roept de module Make an API call elk endpoint uit de API-referentie aan met dezelfde persoonlijke sleutel. Tot dan doet de HTTP-module hetzelfde werk. Gebeurtenissen van Marcomm AI kunnen ook naar een webhookadres van Make gaan dat u toevoegt op het tabblad Webhooks in Instellingen → API.
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. Voeg in de HTTP-module zelf de header Idempotency-Key toe aan elk schrijfverzoek.
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 Make los te koppelen; systemen die hem gebruiken verliezen meteen de toegang.
Veelgestelde vragen
Roep
GET https://marcomm.works/api/v1/meaan met de headerAuthorization: Bearergevolgd 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 Make niet als verbonden. In Instellingen → API ziet u wanneer elke sleutel voor het laatst is gebruikt.
Vul
https://marcomm.works/api/v1in, gevolgd door een pad uit de ontwikkelaarsdocumentatie, bijvoorbeeld/press-releasesvoor de lijst met persberichten.