n8n 2.47 z limitami API: jeden zapętlony workflow nie zablokuje już całej firmy. Co sprawdzić przed włączeniem

Ilustracja strumieni danych przepływających przez bramkę ograniczającą ruch na serwerze automatyzacji (grafika wygenerowana przez AI)

n8n, popularne narzędzie do automatyzacji, które wiele polskich firm i freelancerów stawia na własnym serwerze, dostało funkcję przydatną wszędzie tam, gdzie z jednej instancji korzysta kilka zespołów albo kilka zewnętrznych skryptów. Od wersji 2.47.0 administrator może ograniczyć, ile zapytań do publicznego API wyśle każdy klucz API. Dzięki temu jeden „zapętlony” workflow nie zablokuje pracy całej reszty.

Na czym polega nowość

Do tej pory, gdy jakiś skrypt czy integracja zaczynała zasypywać API n8n tysiącami zapytań, cierpiała na tym cała instancja. Teraz każdy klucz API ma własny licznik. Gdy przekroczy limit, dostaje odpowiedź 429 Too Many Requests, a pozostali użytkownicy pracują dalej bez zakłóceń.

  • Osobne limity na odczyt i zapis. Zapytania GET liczą się jako odczyty, a POST, PUT, PATCH i DELETE jako zapisy. Każdy typ ma limit dla wszystkich endpointów łącznie i osobny dla każdego endpointu.
  • Domyślne wartości (w oknie 60 sekund): 1200 odczytów i 600 zapisów łącznie oraz 1000 odczytów i 500 zapisów na jeden endpoint.
  • Jasne nagłówki. Odpowiedzi zawierają X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset, a odrzucone zapytanie dostaje Retry-After z liczbą sekund do odczekania.
  • Zmiany bez restartu. Limity zmienisz w ustawieniach albo przez API i działają od razu.
  • Skalowanie. W konfiguracjach z kilkoma instancjami głównymi (multi-main) licznik dla klucza jest wspólny dzięki Redisowi.

Ważne: liczą się tylko zapytania wysyłane z kluczem API pod /api/v1. Praca w edytorze n8n nie zużywa limitu. Funkcja jest dostępna w każdym planie, zarówno w n8n Cloud, jak i w wersji self-hosted.

Domyślnie jest wyłączona. Jak ją włączyć

Po aktualizacji nic się samo nie zmieni, bo ograniczenia są domyślnie wyłączone. Włączysz je na trzy sposoby:

  • w panelu: Settings > Policies > Public API Limits, opcja włączenia limitów dla kluczy API,
  • przez API: endpointy /api/v1/settings/rate-limits (klucz musi mieć uprawnienie securitySettings:manage),
  • na własnym serwerze: zmienna środowiskowa N8N_PUBLIC_API_RATE_LIMIT_ENABLED=true i restart, a szczegółowe limity ustawisz zmiennymi z prefiksem N8N_PUBLIC_API_RATE_LIMIT_. Zmienne środowiskowe mają pierwszeństwo przed ustawieniami z panelu.

Uwaga na workflowy, które wołają API własnej instancji

To najczęstsza pułapka. Węzeł n8n i węzeł HTTP Request wysyłają jedno zapytanie na każdy element, więc lista 1000 rekordów to około 1000 zapytań naraz. Po włączeniu limitów taki węzeł po prostu się wywali na błędzie 429. Twórcy n8n radzą dodać w nim Batching (w węźle n8n w Request Options, w HTTP Request w Options) i ustawić liczbę elementów w partii oraz odstęp w milisekundach. Przykład z dokumentacji: 5 elementów co sekundę to 300 zapytań na minutę, czyli poniżej każdego domyślnego limitu.

Opcja Retry On Fail tu nie pomoże: czeka maksymalnie 5 sekund, więc zwykle ponawia próbę w tym samym oknie i znowu dostaje odmowę.

Bezpieczne ponawianie dzięki kluczom idempotencji

Ponowienie zapytania POST niesie ryzyko duplikatu, jeśli pierwsza próba jednak się udała. Dlatego limity działają w parze z nagłówkiem Idempotency-Key, dostępnym od wersji 2.45.0. Gdy zapytanie z takim kluczem się powiedzie, n8n zapamiętuje odpowiedź na 12 godzin, a ponowienie z tym samym kluczem i treścią zwraca zapisaną odpowiedź zamiast tworzyć np. drugi workflow. Jeśli pierwsza próba się nie uda, klucz jest zwalniany i kolejna wykona się normalnie.

Co to oznacza w praktyce

Jeśli masz n8n tylko dla siebie i nie wystawiasz API, możesz spokojnie zaktualizować i nic nie ruszać. Jeśli jednak z instancji korzysta kilka działów, agencja obsługuje na niej klientów albo podłączasz do API agentów AI, którzy potrafią wysłać serię zapytań w pętli, warto włączyć limity. Przed włączeniem przejrzyj workflowy z węzłem n8n lub HTTP Request kierowanym na własną instancję i dodaj Batching, a w swoich skryptach obsłuż nagłówek Retry-After z małym losowym opóźnieniem, żeby klienci nie ponawiali prób jednocześnie.

Źródło: blog n8n, dokumentacja n8n: Rate limits

Artykuł zredagowany przy pomocy AI.

Śledzę AI, dotacje i cyberbezpieczeństwo, żebyś Ty nie musiał. Codziennie wybieram to, co naprawdę ważne, i podaję w pigułce, bez marketingowego bełkotu.

Opublikuj komentarz

Prawdopodobnie można pominąć