Begriff
HTTP Request Node (Der Bote)
Warum wichtig?
Dieser Begriff ist ein Knoten im SengakujiWorks-Wissensnetz. Nutze Level 0 für die erste Einordnung, Level 1 für Praxis, Level 2 für technische Struktur und Level 3 für Grenzen, Fallstricke und Expertenkontext.
Der HTTP Request Node ist der Universal-Dolmetscher. Er erlaubt n8n, mit fast jedem anderen Dienst im Internet zu sprechen, auch wenn es dafür keinen vorgefertigten "Node" gibt. Er ist wie ein Webbrowser für Roboter: Er ruft eine Webseite oder API auf und holt Daten oder sendet welche.
:level0Lernbruecke: Ein HTTP Request Node ist der Bote nach draussen. Er ruft eine URL auf, schickt optional Daten mit und bekommt eine Antwort zurück.
Lernbruecke für Anfänger
Wenn du bei HTTP Request Node (Der Bote) ganz neu startest, denke zuerst nicht an Fachwörter, sondern an die Alltagssituation: APIs aktiv aus n8n heraus ansprechen. Der Begriff beschreibt einen klaren Baustein im größeren Ablauf. Frage dich immer: Was ist der Eingang, was passiert in der Mitte, und woran erkenne ich am Ende, dass es funktioniert hat?
Ein guter Einstieg ist, den Begriff in einem Satz zu erklären, danach ein reales Beispiel zu nennen und erst dann die Technikdetails zu lernen. So entsteht kein reines Auswendiglernen, sondern ein mentales Modell.
Wenn n8n keinen speziellen Node für "Dienst XY" hat, nutzt du diesen Node. Du musst wissen:
- URL: Wohin soll die Anfrage gehen? (
https://api.wetter.de/berlin) - Methode: Was willst du tun?
GET: Daten lesen (z.B. Wetter abfragen).POST: Daten senden (z.B. neuen Kunden anlegen).
- Authentication: Darfst du das? (API Key).
Praxisbeispiel: GET liest Daten aus einer API, POST sendet neue Daten. Header enthalten oft Authentifizierung, der Body enthält die Nutzdaten. Bei 401 fehlt meist die Berechtigung, bei 404 stimmt oft die URL nicht.
Du kannst genau steuern, was gesendet wird:
- Query Parameters:
?search=term(Teil der URL). - Headers:
Content-Type: application/json(Metadaten). - Body: Das eigentliche Paket (JSON payload). Fehlerbehandlung: Schalte "Always Output Data" an, um auch bei 404/500 Fehlern weiterzumachen und den Fehler im Workflow zu behandeln.
:level2
Technisch gehoeren Methode, URL, Header, Query-Parameter, Body und Timeout zusammen. Gute Workflows behandeln Statuscodes bewusst und verlassen sich nicht darauf, dass jede API immer sauber antwortet.
Technische Einordnung im System
Technisch ist HTTP Request Node (Der Bote) nicht isoliert. Es wirkt mit Nachbarbegriffen zusammen, hat Voraussetzungen und erzeugt Folgen. Für ein robustes Verständnis prüfst du drei Fragen: Welche Daten oder Bedingungen braucht dieser Schritt? Welche Ausgabe oder Wirkung entsteht? Was passiert bei falschen, fehlenden oder zu großen Eingaben?
Diese Sicht ist wichtig, weil echte Systeme selten am Hauptpfad scheitern. Sie scheitern an Randfällen, Berechtigungen, Zeitpunkten, Formaten, Reihenfolgen oder stillen Annahmen.
Authentifizierungsmethoden
Der Node unterstützt nativ fast alle Standards:
- Basic Auth: Base64-encoded
user:passim Header. - Bearer Token:
Authorization: Bearer <token>. - Digest Auth: Challenge-Response Verfahren (seltener).
- OAuth2: Nutzt gespeicherte n8n-Credentials, um den Token automatisch in den Header zu patchen.
Pagination (Blättern)
APIs liefern oft nicht alle Daten auf einmal ("Page 1 of 100"). Der HTTP Request Node hat eingebaute Pagination Options:
- "Add all results": Er ruft die nächste Seite automatisch ab, bis keine mehr da sind.
- Du musst konfigurieren, wie die API das mitteilt (z.B.
next_page_urlim JSON oder Link-Header).
Binary Data Handling
Er kann nicht nur JSON.
Wenn du Response Format: File wählst, lädt er Bilder/PDFs herunter und speichert sie im n8n-Binary-Store. Diese kannst du dann an AWS S3, Google Drive oder Telegram weiterleiten.
Proxies & CA Certificates
In Enterprise-Umgebungen musst du oft durch einen Corporate Proxy.
n8n respektiert die Environment-Variablen HTTP_PROXY / HTTPS_PROXY.
Auch eigene CA-Zertifikate (für interne HTTPS-Dienste) können importiert werden (NODE_EXTRA_CA_CERTS), damit der Request nicht an "Self Signed Certificate" Fehlern scheitert.
Socket Hang Ups & Timeouts
Der HTTP Request Node bringt eine häufig übersehene, aber kritische V-Einstellung mit: Timeout-Handling.
Wenn du eine externe Maschine per PING ansprichst und diese wegen eines Netzwerk-DDoS (Distributed Denial of Service) zwar den TCP-Handshake annimmt, aber keine HTTP-Antwort zurückschickt (socket hang up), friert dein kompletter n8n-Workflow-Thread ein, bis der generische Axios-Standard-Timeout (oft 2 Minuten) abläuft.
In Produktionsworkflows musst du unter "Options > Timeout" einen Aggressiven Abbruch (z. B. 5000 ms) definieren, sonst reißen blockierende API-Calls langfristig Speicher und NodeJS-Worker-Threads deines gesamten n8n-Setups mit in den Abgrund.
Exponential Backoff & Circuit Breaking
Dämliche API-Clients senden Anfragen in Endlosschleifen, wenn der Server 503 (Service Unavailable) oder 429 (Too Many Requests) meldet.
Ein Profi-Konzept ist der Exponential Backoff. Der Node kann (via Expressions und Retry-Nodes) so gebaut werden, dass er nach einem Ausfall erst 2 Sekunden, dann 4, dann 8 und am Ende 16 Sekunden pausiert.
n8n bietet im HTTP Node die "Retry" Option out-of-the-box (unter Settings: Retry on Fail = true). Dies ist überlebensnotwendig für REST APIs von Dritten (wie Shopify, Salesforce), die strenge Rate-Limits mit Retry-After-Headern durchdrücken. Verpasst du das Retry-Intervall gnadenlos, wirst du oft per WAF (Web Application Firewall) permanent blockiert.
Steaming und "Split in Batches"
Rufst du eine REST-API auf, die ein 500 MB großes JSON-Array ausspuckt? Der HTTP Request Node liest per Default den kompletten Body ins RAM, um ihn als JSON ans UI zu feuern (Deserialisierung). NodeJS limitiert Heap-Memory oft bei 1.5 GB. Ein solcher Request lässt n8n gnadenlos mit "Fatal Error: heap out of memory" abstürzen. Wenn du Massive Data Pumping machst, musst du die Option "Response Format" auf File/Binary setzen und den Stream manuell parsen, oder Pagination radikal nach unten korrigieren und direkt in einem "Split In Batches"-Loop verarbeiten, um den Garbage Collector (GC) von V8 die Fragmente freigeben zu lassen.
Quick-Check
Wann brauche ich den HTTP Request Node?
Wenn es keinen fertigen Node für den Dienst gibt oder ich volle Kontrolle brauche.Was machen Pagination Options?
Sie blättern automatisch durch mehrseitige API-Ergebnisse und holen alle Daten.Was bedeutet "Bearer Token"?
Ein "Überbringer"-Token im Header, der dem Server beweist, dass du berechtigt bist (wie eine Eintrittskarte).