DamianSlimak.pl
O mnie Szkolenia Automatyzacje
Kursy ▾
Kurs Antigravity IDEDarmowy Kurs PrestaShopDarmowy kurs n8nObsidian jako system pracy
PrestaShop ▾
Programista PrestaShopModuły PrestaShopDarmowy kurs PrestaShop
Blog ▾
Warsztat AINarzędziowniaAutomatyzacjeE-commerce & SEOPunkt widzenia
kontakt

// Credentials

n8n API

▸ // rozdziały lekcji
✓

Na komputerze (localhost)

Działa. Workflow może pytać tę samą instancję pod http://localhost:5678.

✓

Na serwerze

Działa, pod adresem instancji albo pod localhost na tym samym serwerze.

n8n ma własne API: listę workflow, wykonań, tabel. Workflow może z niego korzystać, na przykład żeby co tydzień pobrać wszystkie twoje automatyzacje i zapisać kopię na GitHubie. Do tego potrzebujesz klucza API z twojej instancji n8n.

Krok 1 - klucz API w n8n

  1. W n8n kliknij Settings w lewym dolnym rogu, potem n8n API.
  2. Kliknij Create API key.
  3. W Label wpisz nazwę, na przykład kopia na GitHub. W Expiration wybierz, jak długo klucz ma działać.
  4. W Scopes wybierz zakres uprawnień:
    • All - pełny dostęp: czyta, zmienia i usuwa workflow, poświadczenia i wykonania,
    • Read only - tylko odczyt. Wystarczy do kopii workflow, bo ona niczego w n8n nie zmienia,
    • Custom - wybierasz pojedyncze uprawnienia z listy.
  5. Kliknij Save i skopiuj klucz. n8n pokazuje go w całości tylko raz.

Okno Create API Key w n8n - Label z nazwą kopia na GitHub, Expiration 30 dni i Scopes z opcjami All, Read only i Custom

Haczyk. Dawaj kluczowi tylko te uprawnienia, których potrzebuje. Klucz z All w wycieku pozwala komuś usunąć wszystkie twoje workflow. Klucz Read only pozwala je najwyżej przeczytać. Do tego twórz osobny klucz do każdego zastosowania: jeśli jeden wycieknie, usuwasz tylko jego, a reszta działa dalej.

Krok 2 - poświadczenie w n8n

  1. Overview, zakładka Credentials, Create credential, typ n8n API.
  2. API Key: wklej klucz.
  3. Base URL: adres instancji z końcówką /api/v1.
  4. Zapisz.

Jaki adres wpisać w Base URL:

  • workflow pyta tę samą instancję, na której działa: http://localhost:5678/api/v1. Działa i na komputerze, i na serwerze, bo n8n pod localhost widzi samego siebie,
  • workflow pyta inną instancję, na przykład z komputera serwer: pełny adres tamtej instancji, na przykład https://n8n.twojafirma.pl/api/v1.

Poświadczenie n8n API w n8n - API Key i Base URL http://localhost:5678/api/v1

Pro-tip. Datę wygaśnięcia klucza zapisz w kalendarzu. Kiedy klucz wygaśnie, workflow z kopią przestanie działać bez ostrzeżenia, a zauważysz to dopiero wtedy, kiedy kopia będzie potrzebna.

Podsumowanie

Klucz API tworzysz w Settings, n8n API, osobny do każdego zastosowania i z datą wygaśnięcia. W poświadczeniu n8n API podajesz klucz i adres z końcówką /api/v1. Tę samą instancję wołasz przez http://localhost:5678/api/v1.

Tego poświadczenia używa lekcja Kopia workflow na GitHuba.