Przejdź do treści

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.

  1. 1
    W Marcomm przejdź do Ustawienia → Integracje → Make, aby zobaczyć stan i potrzebne wartości.
    Ustawienia, Integracje, Make, ze stanem, krokami połączenia, zakresami do zaznaczenia i stanem dostępu do API
    Strona Make pokazuje bieżący stan, kroki, wartości do skopiowania oraz to, czy dostęp do API jest zatwierdzony dla tej przestrzeni roboczej.
  2. 2
    Otwó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.
  3. 3
    Po 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.
  4. 4
    W scenariuszu Make dodaj moduł HTTP i wybierz Make a request.
  5. 5
    Wpisz endpoint z dokumentacji dla programistów po https://marcomm.works/api/v1 i dodaj nagłówek Authorization z Bearer oraz 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/me z nagłówkiem Authorization: Bearer i 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/v1 i ścieżkę z dokumentacji dla programistów, na przykład /press-releases, aby pobrać listę komunikatów prasowych.

Integracje