Make mit dem HTTP-Modul verbinden
Die Marcomm-AI-App für Make ist in Prüfung. Bis zur Freigabe rufen Sie die API von Marcomm AI in einem Make-Szenario mit dem HTTP-Modul und einem persönlichen API-Schlüssel auf.
- 1Öffnen Sie in Marcomm Einstellungen → Integrationen → Make, um den Status und die benötigten Werte zu sehen.

Die Seite Make zeigt den aktuellen Status, die Schritte, die zu kopierenden Werte und ob der API-Zugang für diesen Workspace freigegeben ist. - 2Öffnen Sie Einstellungen → API. Hat der Workspace noch keinen API-Zugang, füllt ein Owner oder Admin API-Zugang beantragen aus und wählt Antrag senden.
- 3Nach der Freigabe öffnen Sie Schlüssel erstellen, wählen Persönlicher Schlüssel, haken die nötigen Bereiche an und wählen Schlüssel erstellen. Kopieren Sie den Schlüssel sofort, er wird nur einmal angezeigt.
- 4Fügen Sie in einem Make-Szenario das Modul HTTP hinzu und wählen Sie Make a request.
- 5Tragen Sie einen Endpunkt aus der Entwicklerdokumentation nach
https://marcomm.works/api/v1ein und fügen Sie den HeaderAuthorizationmitBearerund Ihrem Schlüssel hinzu.
Prüfen Sie den Schlüssel zuerst mit GET /me, bevor Sie den Rest des Szenarios bauen.
Die Marcomm-AI-App für Make ist in Prüfung und kann noch nicht hinzugefügt werden. Nach der Freigabe ruft ihr Modul Make an API call mit demselben persönlichen Schlüssel jeden Endpunkt der API-Referenz auf. Bis dahin erledigt das HTTP-Modul dieselbe Arbeit. Ereignisse von Marcomm AI können auch an eine Webhook-Adresse von Make gehen, die Sie im Tab Webhooks unter Einstellungen → API hinzufügen.
Bereiche legen fest, was ein Schlüssel darf. Inhalte (content) liest Pressemitteilungen, Blogbeiträge und Presse-Events, Inhalte schreiben (content:write) erstellt und bearbeitet Entwürfe, Veröffentlichen und senden (distribution) veröffentlicht und versendet per E-Mail, und Freigaben (approvals) deckt Freigabeschritte ab. Die letzten drei funktionieren nur mit dem Schlüsseltyp Persönlicher Schlüssel, weil die Aktion unter der Person gespeichert wird, die den Schlüssel erstellt hat. Ein Workspace-Schlüssel kann nur lesen, und jeder Schlüssel handelt mit der Rolle und den Rechten seiner Erstellerin oder seines Erstellers.
Veröffentlichen und Versenden lassen sich nicht rückgängig machen. Die API führt sie nur aus, wenn die Anfrage confirm: true oder einen Idempotency-Key-Header enthält, und sie veröffentlicht nichts und antwortet mit 409, solange noch eine Freigabe nötig ist oder der Inhalt geplant oder unter Sperrfrist ist. Eine Wiederholung mit demselben Idempotency-Key und derselben Anfrage liefert 24 Stunden lang das erste Ergebnis, statt erneut zu laufen. Im HTTP-Modul fügen Sie den Header Idempotency-Key bei jeder schreibenden Anfrage selbst hinzu.
Die API ist ab dem Team-Tarif verfügbar. Das Team von Marcomm AI prüft jeden Antrag, und Schlüssel funktionieren erst nach der Freigabe. Ein Schlüssel kann nur die für den Workspace freigegebenen Bereiche nutzen, und jede Person kann bis zu 10 Schlüssel haben. Standardmäßig sind pro Workspace 60 Anfragen pro Minute und 10.000 pro Tag möglich; darüber antwortet die API mit 429 und einem Retry-After-Header. Für höhere Limits nutzen Sie Höhere Limits nötig? unter Einstellungen → API. Um Make zu trennen, wählen Sie Widerrufen neben dem Schlüssel; Systeme, die ihn nutzen, verlieren sofort den Zugriff.
FAQs
Rufen Sie
GET https://marcomm.works/api/v1/memit dem HeaderAuthorization: Bearerund Ihrem Schlüssel auf. Das klappt mit jedem freigegebenen Schlüssel, unabhängig von seinen Bereichen, und liefert den Workspace, den Namen des Schlüssels und seine Bereiche.Ein Schlüssel speichert nicht, welcher Dienst ihn nutzt, daher markiert Marcomm die Karte Make nicht als verbunden. Unter Einstellungen → API sehen Sie, wann jeder Schlüssel zuletzt genutzt wurde.
Tragen Sie
https://marcomm.works/api/v1ein, gefolgt von einem Pfad aus der Entwicklerdokumentation, zum Beispiel/press-releasesfür die Liste der Pressemitteilungen.