Przejdź do treści

Połącz n8n za pomocą osobistego klucza API

Węzeł społeczności n8n-nodes-marcomm pisze komunikaty prasowe, wpisy na blogu, wydarzenia prasowe i zaproszenia RSVP, kieruje je do zatwierdzenia i publikuje. Pakiet nie jest jeszcze opublikowany.

  1. 1
    W Marcomm przejdź do Ustawienia → Integracje → n8n, aby zobaczyć stan i potrzebne wartości.
    Ustawienia, Integracje, n8n, ze stanem, krokami połączenia, zakresami do zaznaczenia i stanem dostępu do API
    Strona n8n 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 n8n Cloud wyszukaj Marcomm AI w panelu węzłów (jeśli się nie pojawia, włącz Verified Community Nodes w panelu administratora i uruchom instancję ponownie). W n8n uruchomionym na własnym serwerze otwórz Settings (Ustawienia), potem Community Nodes, potem Install (Zainstaluj) i wpisz n8n-nodes-marcomm.
  5. 5
    Utwórz poświadczenie Marcomm AI API, wklej klucz w polu API Key (klucz API) i dodaj do workflow węzeł Marcomm AI lub Marcomm AI Trigger.

Węzeł wyzwalacza potrzebuje uprawnienia Treści i przy pierwszym sprawdzeniu nic nie wysyła, więc nie uruchamia się dla starszych elementów.

Węzeł obsługuje komunikaty prasowe, wpisy na blogu, wydarzenia prasowe, zaproszenia RSVP i zatwierdzenia, w tym zatwierdzanie, odrzucanie i listę oczekujących zatwierdzeń. Węzeł wyzwalacza uruchamia workflow, gdy komunikat prasowy zostanie utworzony, skierowany do zatwierdzenia lub opublikowany, gdy wpis na blogu zostanie utworzony lub opublikowany albo gdy powstanie wydarzenie prasowe.

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ęzeł wysyła klucz idempotencji przy każdym zapisie, utworzony z wykonania, węzła i elementu, a publikowanie i wysyłkę potwierdza sam.

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ć n8n, 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 n8n jako połączonej. W Ustawienia → API widać, kiedy każdy klucz był ostatnio użyty.

Tak, za pomocą wbudowanego węzła HTTP Request. Wywołuj https://marcomm.works/api/v1 z nagłówkiem Authorization: Bearer i swoim kluczem oraz dodawaj nagłówek Idempotency-Key do każdego zapisu.

Integracje