Połącz Make przez moduł HTTP
Aplikacja Marcomm AI dla Make jest w weryfikacji. Do czasu zatwierdzenia wywołuj API Marcomm AI ze scenariusza Make modułem HTTP i osobistym kluczem API.
- 1W Marcomm przejdź do Ustawienia → Integracje → Make, aby zobaczyć stan i potrzebne wartości.

Strona Make pokazuje bieżący stan, kroki, wartości do skopiowania oraz to, czy dostęp do API jest zatwierdzony dla tej przestrzeni roboczej. - 2Otwórz Ustawienia → API. Jeśli przestrzeń robocza nie ma jeszcze dostępu do API, właściciel lub administrator wypełnia Złóż wniosek o dostęp do API i wybiera Wyślij wniosek.
- 3Po zatwierdzeniu otwórz Utwórz klucz, wybierz Klucz osobisty, zaznacz potrzebne Uprawnienia i wybierz Utwórz klucz. Od razu skopiuj klucz, bo jest pokazywany tylko raz.
- 4W scenariuszu Make dodaj moduł HTTP i wybierz Make a request.
- 5Wpisz endpoint z dokumentacji dla programistów po
https://marcomm.works/api/v1i dodaj nagłówekAuthorizationzBeareroraz swoim kluczem.
Zacznij od GET /me, aby sprawdzić klucz, zanim zbudujesz resztę scenariusza.
Aplikacja Marcomm AI dla Make jest w weryfikacji i nie można jej jeszcze dodać. Po zatwierdzeniu jej moduł Make an API call wywoła dowolny endpoint z dokumentacji API tym samym osobistym kluczem. Do tego czasu tę samą pracę wykonuje moduł HTTP. Zdarzenia Marcomm AI mogą też trafiać na adres webhooka Make dodany na karcie Webhooki w Ustawienia → API.
Uprawnienia określają, co może klucz. Treści (content) odczytuje komunikaty prasowe, wpisy na blogu i wydarzenia prasowe, Pisanie treści (content:write) tworzy i edytuje wersje robocze, Publikowanie i wysyłka (distribution) publikuje i wysyła e-mailem, a Zatwierdzenia (approvals) obejmuje kroki zatwierdzania. Trzy ostatnie działają tylko z typem Klucz osobisty, bo działanie jest zapisywane na osobę, która utworzyła klucz. Klucz przestrzeni roboczej może tylko odczytywać, a każdy klucz działa z rolą i uprawnieniami swojego twórcy.
Publikowania i wysyłki nie można cofnąć. API wykonuje je tylko wtedy, gdy żądanie zawiera confirm: true lub nagłówek Idempotency-Key, i nic nie publikuje, odpowiadając 409, dopóki potrzebne jest zatwierdzenie albo treść jest zaplanowana lub objęta embargiem. Ponowienie z tym samym Idempotency-Key i tym samym żądaniem przez 24 godziny zwraca pierwszy wynik zamiast wykonywać je jeszcze raz. W module HTTP sam dodawaj nagłówek Idempotency-Key do każdego żądania zapisu.
API jest dostępne od planu Team wzwyż. Zespół Marcomm AI sprawdza każdy wniosek, a klucze działają dopiero po zatwierdzeniu. Klucz może używać tylko uprawnień zatwierdzonych dla przestrzeni roboczej, a każda osoba może mieć do 10 kluczy. Domyślnie przestrzeń robocza może wysłać 60 żądań na minutę i 10 000 na dzień; powyżej API odpowiada 429 z nagłówkiem Retry-After. Aby podnieść limity, użyj Potrzebujesz wyższych limitów? w Ustawienia → API. Aby odłączyć Make, wybierz Unieważnij obok klucza; systemy, które go używają, od razu tracą dostęp.
Najczęstsze pytania
Wywołaj
GET https://marcomm.works/api/v1/mez nagłówkiemAuthorization: Beareri swoim kluczem. Działa to z każdym zatwierdzonym kluczem bez względu na jego uprawnienia i zwraca przestrzeń roboczą, nazwę klucza oraz jego uprawnienia.Klucz nie zapisuje, która usługa go używa, więc Marcomm nie oznacza karty Make jako połączonej. W Ustawienia → API widać, kiedy każdy klucz był ostatnio użyty.
Wpisz
https://marcomm.works/api/v1i ścieżkę z dokumentacji dla programistów, na przykład/press-releases, aby pobrać listę komunikatów prasowych.