Gdy n8n nie ma gotowego węzła dla systemu albo wbudowany węzeł nie obsługuje potrzebnej operacji, używasz węzła HTTP Request, czyli niestandardowego wywołania API. Podajesz adres endpointu, metodę (GET, POST, PUT, PATCH, DELETE), nagłówki, parametry i treść, a jako uwierzytelnienie możesz wskazać istniejące poświadczenia danego serwisu (predefined credential) albo ogólne: API key, Bearer, Basic Auth czy OAuth2. Dzięki temu n8n połączy się praktycznie z każdym systemem, który ma API.
Kiedy HTTP Request zamiast gotowego węzła
- system nie ma węzła w n8n (np. lokalny ERP, TMS, system kurierski),
- wbudowany węzeł nie ma potrzebnej operacji lub pola,
- chcesz użyć nowej funkcji API, której węzeł jeszcze nie obsługuje.
Jak skonfigurować niestandardowe wywołanie API
- Znajdź w dokumentacji API endpoint, metodę i wymagane pola.
- Wklej przykładowe polecenie cURL do węzła HTTP Request (opcja importu cURL), żeby szybciej uzupełnić pola.
- Wybierz uwierzytelnienie: przy serwisie z węzłem w n8n możesz użyć jego poświadczeń, co oszczędza konfigurację OAuth.
- Ustaw paginację, jeśli API zwraca wyniki na stronach.
- Włącz ponawianie przy błędach i obsłuż kody 4xx/5xx w kolejnych krokach.
Typowe problemy
| Problem | Rozwiązanie |
|---|---|
| Błąd 401/403 | Sprawdź zakres uprawnień tokenu i format nagłówka |
| Błąd 429 (limit zapytań) | Partie, pauza między wywołaniami, ponowienie z opóźnieniem |
| Tylko część wyników | Skonfiguruj paginację (strona, kursor lub link do następnej strony) |
| Nieczytelna odpowiedź (XML, plik) | Ustaw format odpowiedzi i użyj węzła XML lub Extract from File |
Przykład: system kurierski bez węzła
Firma e-commerce potrzebowała etykiet z systemu kurierskiego, dla którego n8n nie miał węzła. Workflow po nowym zamówieniu wysyła przez HTTP Request dane przesyłki do API przewoźnika, odbiera PDF etykiety, zapisuje go na dysku i przekazuje numer śledzenia do sklepu. Podobne scenariusze znajdziesz w zakładkach automatyzacje InPost i automatyzacje DPD.
Gdy ta sama integracja jest używana w wielu workflow, warto zamienić ją we własny węzeł. Opisaliśmy to w artykule o community nodes w n8n.
Integracje przez API z Codeless
Zobacz automatyzacje n8n albo umów bezpłatną konsultację.