Zum Hauptinhalt springen

HTTP-Anfrage ausführen

Einen beliebigen HTTP- oder HTTPS-Endpunkt als Teil eines Workflows aufrufen.

Funktionsweise​

Der Schritt sendet eine HTTP-Anfrage an eine URL mit einer Methode Ihrer Wahl (GET, POST, PUT, DELETE, PATCH), schickt optional einen Body mit und schreibt die Antwort in den Speicher zurück. Er ist das universelle Bindeglied zu jedem System, das eine Web-API hat.

Einstellungen​

FeldWas es steuertErforderlichHinweise
URLDie aufzurufende Adresse.erforderlichMuss eine gültige HTTP- oder HTTPS-URL sein.
HTTP-MethodeDie HTTP-Methode.erforderlichGET, POST, PUT, DELETE oder PATCH.
Inhalt/BodyDer Body der Anfrage aus dem Speicher.optionalFür POST, PUT und PATCH. Aus dem Speicher übernommen; meist ein JSON-String, der in einem vorherigen Schritt zusammengesetzt wurde.
Antwort (optional)Wo der Body der Antwort im Speicher abgelegt wird.optionalEin späterer Schritt kann ihn auswerten oder weiterleiten.

📷 SCREENSHOT: Der Schritt „HTTP-Anfrage ausführen“ mit URL, Auswahlliste für die HTTP-Methode, Speicherauswahl für den Body und Speicherausgabe für die Antwort.

Beispielszenario​

Ein externes System nach einer KI-Entscheidung anstoßen. Ein Workflow entscheidet mit einer KI-Aktion, ob ein Vorgang dringend ist. Wenn ja, ruft ein nachfolgender Schritt „HTTP-Anfrage ausführen“ die API Ihres Incident-Managements auf und legt ein Ticket an. Wenn nein, endet der Workflow ohne weitere Aktion.

Empfehlungen​

  • ✅ Verwenden Sie für jede nicht interne Adresse immer HTTPS.
  • ✅ Legen Sie die Antwort im Speicher ab, auch wenn Sie glauben, sie nicht zu brauchen. Die Ansicht Jobs zeigt sie an, was bei der Fehlersuche in fehlgeschlagenen Läufen hilft.
  • ✅ Verlangt der Endpunkt eine Authentifizierung, nutzen Sie nach Möglichkeit die Datenbankabfrage oder anbieterspezifische Integrationen – sie gehen sauberer mit Zugangsdaten um. Header (Authorization, eigene Schlüssel) betten Sie nur dann direkt in die URL ein, wenn die API eine Authentifizierung per Query-String unterstützt; andernfalls erwägen Sie einen eigenen Wrapper-Dienst.
  • ⚠️ Die Integration verwendet ein sinnvoll gewähltes Standard-Timeout. Endpunkte, die länger brauchen, lassen den Schritt fehlschlagen. Für lang laufende Vorgänge bietet sich ein asynchrones Muster an (Anfrage absenden, ohne auf das Ergebnis zu warten, plus ein Webhook-Trigger für das Ergebnis).
  • ❌ Schreiben Sie keine Geheimnisse direkt in die URL, wo sie in Protokollen landen würden. Verwenden Sie URLs auf Umgebungsebene und authentifizieren Sie sich bei Bedarf über einen Proxy, der die Header ergänzt.

Nächste Schritte​