DokumentationWorkflowsApps und Services
HTTP Node
Ruft eine externe URL auf, z.B. eine API, einen anderen Webhook oder einen MCP-Server. Auth, Body, Headers und Query-Parameter können aus Templates gefüllt werden. Der Antwort-Body wird automatisch als JSON geparst. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.
10 Min LesezeitAktualisiert am
Was HTTP macht
Ruft eine externe URL auf, z.B. eine API, einen anderen Webhook oder einen MCP-Server. Auth, Body, Headers und Query-Parameter können aus Templates gefüllt werden. Der Antwort-Body wird automatisch als JSON geparst.
- Verarbeitet einen Eingang.
- Stellt einen Ausgang für weitere Schritte bereit.
- Wird als normaler Schritt in den Ablauf eingebunden.
Node einrichten
- 01Öffne einen Workflow und füge „HTTP“ über Bausteine hinzu.
- 02Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
- 03Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
- 04Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.
Aktionen und Betriebsarten
HTTP hat eine klar abgegrenzte Aufgabe. Die verfügbaren Einstellungen erscheinen direkt im Node-Panel, sobald du den Node auswählst.
Einstellungen
| Feld | Bedeutung | Bereich |
|---|---|---|
| Methode | Auswahl: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS | Standard |
| URL | Wird im Node-Panel konfiguriert. | Standard |
| Authentifizierung | Wie sich die externe API authentifiziert. Token / Key / Passwort kommen ins jeweilige Feld unten. | Standard |
| Zugangsdaten aus Workflow-Secret | Wähle das Workflow-Secret mit Token, API-Key oder Basic-Auth-Passwort. Der Klartext landet nie im Workflow-JSON. | Standard |
| Name des Schlüssel-Feldes | Wie das Feld heisst, in dem die API deinen Schlüssel erwartet. Steht meist in der API-Doku, oft X-API-Key. | Standard |
| Name des Schlüssel-Parameters in der URL | Wie der Parameter in der URL heisst, der deinen Schlüssel traegt, z.B. ?api_key=… . Steht in der API-Doku. | Standard |
| Username | Wird im Node-Panel konfiguriert. | Standard |
| Query-Parameter | Werden als ?key=value an die URL gehängt. Bestehende Query-Strings in der URL bleiben erhalten. | Standard |
| Headers | Schlüssel/Wert-Paare als Felder. Authorization wird automatisch über das Auth-Feld oben gesetzt, hier nur Custom-Header. | Standard |
| Body-Format | Wie der Body übertragen wird. 'Form' für ältere APIs, die Felder wie Formulardaten erwarten; 'Roh' für XML oder reinen Text. Im Zweifel: Automatisch. | Erweitert |
| Body | No-Code-Editor: Feld + Wert hinzufügen, der Typ (Text/Zahl/Boolean/JSON) wird automatisch erkannt. Oben rechts kannst du auf Roh-JSON umschalten. | Standard |
| Antwort lesen als | JSON stoppt den Workflow, wenn die Antwort keine gültigen strukturierten Daten enthält. | Erweitert |
| Weitergeben | Bei empfangenen Listen kann der nächste Schritt jeden Eintrag einzeln verarbeiten. | Erweitert |
| Name für Text oder Datei | Unter diesem Namen findet der nächste Schritt den Text oder die Datei. Strukturierte JSON-Daten behalten ihre eigenen Feldnamen. | Erweitert |
| Importvertrag | Wird im Node-Panel konfiguriert. | Erweitert |
| Datenformat des Imports | Wird im Node-Panel konfiguriert. | Erweitert |
| Weiterleitungen folgen | Ruft bei einer Weiterleitung die neue Adresse auf. Ausgeschaltet erhält der nächste Schritt die erste Antwort. | Erweitert |
| Bei HTTP-Fehler | „Weiterlaufen" lässt den Workflow auch bei 4xx/5xx oder Netzwerk-Fehlern weiterlaufen, du checkst $json.ok und reagierst (Retry, Fallback, Log). | Erweitert |
| Abbrechen nach (Millisekunden) | Bricht die Anfrage ab, wenn die andere Seite zu lange braucht. In Millisekunden (1000 = 1 Sekunde). Maximal 30000 (30 Sekunden). | Erweitert |
| Maximale Antwort-Größe (Bytes) | Größere Antworten werden abgebrochen, damit der Workflow nicht überlastet. Angabe in Bytes (5000000 = 5 MB). Standard 5 MB, Maximum 10 MB. | Erweitert |
| Für jedes Item einzeln senden | Aus (Standard): eine Anfrage für den gesamten Input. An: bekommt dieser Node mehrere Items (z.B. aus Split Out oder einem Code-Node), wird für JEDES Item eine eigene Anfrage geschickt, {{ $json }} ist dann pro Anfrage das jeweilige Item. Praktisch, um eine externe API oder Schnittstelle nicht mit Parallel-Last zu überlasten. | Erweitert |
| Pause zwischen Items (Millisekunden) | Wartezeit vor jeder Anfrage außer der ersten. 10000 = 10 Sekunden pro Item. Maximal 300000 (5 Minuten). | Erweitert |
Eingaben und Ausgaben
| Eingabe | Bedeutung | Typ |
|---|---|---|
| url | Ziel-URL. Überschreibt das Konfig-Feld. | text |
| body | Request-Body. | json |
| Ausgabe | Bedeutung | Typ |
|---|---|---|
| body | Antwort-Body (geparstes JSON, sonst Text). | json |
| status | HTTP-Statuscode. | number |
| ok | true bei 2xx, false sonst. | boolean |
| headers | Antwort-Header (Lowercase-Keys). | json |
Beispiel und Testlauf
API-GET mit Bearer-Token: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.
Beispiel für einen Testlauf
{
"query": "anymize",
"limit": 10
}Zugriff und Sicherheit
Prüfe vor der Aktivierung, welche Daten in diesen Schritt gelangen und welche Daten seine Ausgabe enthält.
Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.
Häufige Fehler beheben
- Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
- Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.