Jak korzystać z węzła HTTP Request w n8n — integracja z dowolnym API
Węzeł HTTP Request to Twój klucz do integracji z każdym REST API — od pogody po własny system rezerwacji. Bez pisania kodu, bez ograniczeń.
Spis treści
- Czym jest węzeł HTTP Request w n8n i kiedy go używać
- Jak skonfigurować węzeł HTTP Request krok po kroku
- Przykłady integracji przez HTTP Request
- Jak przetwarzać odpowiedzi API w n8n
- Często zadawane pytania
Czym jest węzeł HTTP Request w n8n i kiedy go używać
N8n posiada setki gotowych węzłów integracyjnych: Gmail, Slack, Google Sheets, HubSpot, Stripe i wiele innych. Ale co, gdy potrzebujesz połączyć się z API, które nie ma dedykowanego węzła? Albo gdy chcesz wywołać własne API? Tu wchodzi węzeł HTTP Request — uniwersalny klient HTTP, który pozwala komunikować się z dowolnym API obsługującym protokół HTTP.
Węzeł HTTP Request sprawdza się w kilku sytuacjach. Po pierwsze, gdy API nie ma dedykowanego węzła w n8n — np. własny system ERP, API lokalnego dostawcy, niszowa aplikacja SaaS. Po drugie, gdy potrzebujesz pełnej kontroli nad żądaniem: niestandardowe nagłówki, specyficzny format body, ręczna obsługa kodów odpowiedzi. Po trzecie, gdy korzystasz z GraphQL zamiast REST — HTTP Request obsługuje oba. Po czwarte, gdy chcesz wywołać publiczne API bez uwierzytelnienia: dane pogodowe, kursy walut, geolokalizacja IP.
Węzeł obsługuje wszystkie standardowe metody HTTP: GET (pobieranie danych), POST (tworzenie zasobów), PUT i PATCH (aktualizacja), DELETE (usuwanie). Obsługuje też różne formaty body: JSON, form-data, binary, raw text. Potrafi wysyłać pliki i odbierać odpowiedzi binarne. Mówiąc prosto — jeśli można to zrobić w przeglądarce lub przez curl, HTTP Request w n8n też to potrafi.
Jak skonfigurować węzeł HTTP Request krok po kroku
W edytorze workflow kliknij plus i wyszukaj "HTTP Request". Dodaj węzeł. Na ekranie konfiguracji masz dwie sekcje: podstawową (metoda, URL) i rozszerzoną (nagłówki, autoryzacja, body). Zacznij od wyboru metody HTTP w polu Method — dla pobierania danych wybierz GET, dla wysyłania POST. Wpisz pełny URL API, np. https://api.openweathermap.org/data/2.5/weather.
W sekcji Authentication wybierz metodę autoryzacji. Dla API Key: wybierz Header Auth, podaj nazwę nagłówka (np. X-Api-Key) i wartość klucza — najlepiej przez Credentials n8n, żeby klucz był bezpiecznie zaszyfrowany. Dla Bearer Token: wybierz Bearer Auth i wklej token. Dla Basic Auth: podaj login i hasło. Jeśli API wymaga niestandardowych nagłówków (Content-Type, Accept, X-Custom-Header), dodaj je w sekcji Headers.
Dla metody GET parametry dodaj w sekcji Query Parameters: kliknij Add Parameter i podaj nazwę oraz wartość (np. q=Warsaw&appid=KLUCZ&units=metric dla API pogody). Dla POST w sekcji Body wybierz typ JSON i wpisz treść żądania jako obiekt JSON lub użyj wyrażeń, żeby dynamicznie wstawiać dane z poprzednich węzłów, np. {"email": "{{ $json.email }}", "name": "{{ $json.name }}"}.
Kliknij Execute Node (przycisk play na węźle) — n8n wyśle żądanie i pokaże odpowiedź w panelu Output. Sprawdź strukturę zwróconego JSON. Jeśli API zwróciło błąd, przeczytaj kod statusu i treść błędu — zazwyczaj wskazują na problem z URL, kluczem API lub formatem body. Po pomyślnym teście połącz węzeł HTTP Request z kolejnymi węzłami, używając danych z odpowiedzi API.
Przykłady integracji przez HTTP Request
Dane pogodowe z OpenWeatherMap: skonfiguruj węzeł GET z URL https://api.openweathermap.org/data/2.5/weather i parametrami q (nazwa miasta) oraz appid (klucz API, darmowy plan wystarczy). N8n odbiera JSON z temperaturą, wilgotnością, prędkością wiatru i opisem pogody. Dołącz węzeł Slack lub Email, żeby wysyłać poranny raport pogodowy do zespołu każdego ranka o 7:00.
Kurs walut z NBP API: Narodowy Bank Polski udostępnia bezpłatne API kursów walut bez uwierzytelnienia. Wywołaj GET na https://api.nbp.pl/api/exchangerates/rates/a/usd/?format=json, żeby pobrać aktualny kurs dolara. Harmonogram Cron w n8n może codziennie o 9:00 pobierać kursy EUR, USD i GBP i zapisywać je do arkusza Google Sheets — masz automatyczny dziennik kursów walut.
Własne API firmy: masz wewnętrzny system (ERP, CRM, aplikacja własna) z REST API? HTTP Request pozwala integrować go z dowolnymi innymi systemami. Np. nowe zamówienie w systemie ERP triggeruje webhook → n8n pobiera szczegóły przez GET na wewnętrzne API → tworzy fakturę w systemie FK przez POST → wysyła potwierdzenie emailem do klienta. Cały proces działa bez udziału człowieka.
System rezerwacji: integracja z API systemu rezerwacji (Calendly, Acuity, Cal.com) przez HTTP Request pozwala automatycznie: sprawdzać dostępność terminów, tworzyć rezerwacje z danych formularza, wysyłać przypomnienia SMS przez API Twilio na 24 godziny przed wizytą i oznaczać zakończone wizyty w CRM.
Jak przetwarzać odpowiedzi API w n8n
Większość API zwraca dane w formacie JSON. N8n automatycznie parsuje odpowiedź — w Output węzła HTTP Request widzisz już obiekt JavaScript, nie surowy tekst. Możesz od razu odwoływać się do pól używając wyrażeń: {{ $json.temperature }}, {{ $json.user.email }}, {{ $json.orders[0].id }}.
Filtrowanie danych: gdy API zwraca tablicę wyników (np. listę 50 produktów), użyj węzła Filter, żeby wybrać tylko te spełniające warunek (np. products gdzie stock > 0 i price < 100). Węzeł Item List pozwala sortować, limitować i usuwać duplikaty z listy.
Mapowanie pól: API zewnętrzne często używa różnych nazw pól niż Twój docelowy system. Węzeł Set pozwala zmapować pola: ustaw nową wartość firstName pobierając ją z {{ $json.first_name }} API. Dzięki temu dane są gotowe do użycia w następnym węźle bez dodatkowego kodu.
Agregacja danych z wielu wywołań: gdy musisz pobrać dane z paginowanego API (strona 1, strona 2...) lub zebrać dane z wielu endpointów, użyj węzła Merge. Zbiera on dane z wielu gałęzi workflow i scala je w jeden strumień. N8n obsługuje też wbudowaną paginację w węźle HTTP Request — włącz Pagination i ustaw parametry, a n8n sam przejdzie przez wszystkie strony.
Często zadawane pytania
Jak przekazać dane uwierzytelniające do API z n8n?
W węźle HTTP Request w sekcji Authentication wybierz odpowiednią metodę: Header Auth (nagłówek Authorization: Bearer TOKEN lub X-API-Key: KLUCZ), Basic Auth (login i hasło zakodowane w Base64), Query Auth (klucz API jako parametr URL). Dane uwierzytelniające zapisz jako Credentials w n8n — nigdy nie wpisuj ich bezpośrednio w URL lub w treści węzła, żeby nie były widoczne w historii wykonań.
Jak obsłużyć błędy API w n8n?
W węźle HTTP Request włącz opcję Continue On Fail — workflow nie zatrzyma się przy błędzie HTTP (4xx, 5xx), a dane o błędzie będą dostępne w output węzła. Dodaj węzeł IF sprawdzający $json.error lub status kod. Możesz też użyć węzła Error Trigger jako osobnego workflow, który poinformuje Cię o nieudanym wykonaniu przez Slack lub email.
Czy n8n obsługuje API z paginacją?
Tak. N8n ma wbudowaną obsługę paginacji w węźle HTTP Request. Włącz Pagination w sekcji ustawień, wybierz typ paginacji (offset, page number, cursor) i podaj parametry. N8n automatycznie będzie wykonywał kolejne żądania, aż pobierze wszystkie strony wyników i scali je w jeden zestaw danych.
Chcesz uruchomić n8n bez konfiguracji serwera?
smartxhosting.pl oferuje n8n w gotowym kontenerze Docker za 10 zł/miesiąc. Darmowy SSL, 10 GB przestrzeni i dostęp przez przeglądarkę — gotowe w kilka minut.
Zamów hosting n8n
