Flexie

Antwort an den Aufrufer

Zuletzt aktualisiert 23 May 2026

Ein Workflow erzeugt fünf verschiedene Antworten, data, html, redirect, continue und einen SSE-Stream

Die Antwort steuert der Antworttyp (return_type) des Endpunkt-Listeners, der beim Erstellen des Endpunkts festgelegt wird. Alle Antwortkörper unterstützen Flexie Scripting, sie können also die eingehenden Daten und alles enthalten, was Ihre Schritte erzeugt haben.

data JSON · XML · HTML automatisch erkannt return_data HTTP 200 html eine Webseite browserfreundlich return_html HTTP 200 redirect Aufrufer umleiten auf eine URL return_redirect HTTP 302 continue Schritt bestimmt die Antwort Sync-Workflow Antwort-Aktion sse gestreamt progressiv Sync erforderlich Server-Sent Events

Die fünf Antworttypen

1. data, ein Körper, den Sie definieren

Geben Sie einen festen (oder mit Tokens gefüllten) Körper zurück. Flexie erkennt automatisch, ob es sich um JSON, XML oder HTML handelt, und setzt den Content-Type entsprechend. Zurückgegeben mit HTTP 200.

Feld: return_data.

{ "status": "received", "ref": "{{ __data.case_ref }}" }

Das ist die Standardwahl für Webhooks: den Empfang bestätigen und optional eine ID zurückgeben, die Ihr Workflow erzeugt hat.

2. html, eine HTML-Seite

Geben Sie eine HTML-Seite zurück. Nützlich, wenn ein Browser den Endpunkt aufruft und Sie etwas anzeigen möchten.

Feld: return_html.

<html><body><h1>Thanks, {{ __data.first_name }}</h1></body></html>

3. redirect, den Aufrufer woandershin schicken

Geben Sie eine Weiterleitung auf eine von Ihnen angegebene URL zurück (HTTP 302). Nützlich für „absenden und dann zu einer Dankesseite gehen".

Feld: return_redirect.

https://example.com/thank-you?ref={{ __data.case_ref }}

4. continue, den Workflow über die Antwort entscheiden lassen

Statt einer festen Antwort wird die Antwort von einem Schritt innerhalb des Workflows erzeugt: der Aktion Endpunkt-Antwort. Verwenden Sie dies, wenn die Antwort davon abhängt, was der Workflow findet oder berechnet, also unterschiedliche Antworten in unterschiedlichen Zweigen.

So funktioniert es:

  • Fügen Sie an der Stelle im Baum, an der Sie die Antwort kennen, eine Aktion Endpunkt-Antwort hinzu. Sie hat ihren eigenen return_type (data, html oder redirect) und das passende Körper- oder URL-Feld.
  • Der Workflow läuft, erreicht diese Aktion, und die Ausgabe der Aktion wird zur Antwort an den Aufrufer.

Das Timing hängt vom Ausführungsmodus des Workflows ab:

  • Sync-Workflow: Der Endpunkt hält die Anfrage offen und antwortet in dem Moment, in dem die Antwort-Aktion ausgelöst wird, eine echte Anfrage mit Antwort.
  • Async-Workflow: Der Endpunkt wartet bis zu 20 Sekunden auf die Antwort. Wird die Antwort-Aktion innerhalb dieses Zeitfensters ausgelöst, erhält der Aufrufer sie; andernfalls läuft die Anfrage in einen Timeout. Für zuverlässige continue-Antworten ist ein Sync-Workflow vorzuziehen, damit die Antwort innerhalb der Anfrage erzeugt wird.

5. sse, eine live gestreamte Antwort

Streamen Sie eine Antwort als Folge von Ereignissen (Server-Sent Events), für progressive Ausgabe wie eine lang laufende Berechnung oder KI-Ausgabe, die Stück für Stück erscheint. Die Schritte des Workflows senden Frames, während sie laufen, und ein abschließender Frame schließt den Stream.

sse erfordert, dass der Workflow im Sync-Modus läuft. Ein Async-Workflow hat kein Ziel, an das gestreamt werden könnte. Setzen Sie den Ausführungsmodus auf Sync, bevor Sie sich auf Streaming verlassen.

Auswahl

Sie möchten … Verwenden
Eine feste Bestätigung oder ein Echo data
Eine Webseite anzeigen html
Den Aufrufer auf eine andere URL umleiten redirect
Eine Antwort, die davon abhängt, was der Workflow findet continue (Sync-Workflow)
Progressive oder gestreamte Ausgabe sse (Sync-Workflow)

Ein Hinweis zur Sicherheit

Die Antwort kann eingehende Daten und berechnete Werte enthalten. Achten Sie darauf, einem nicht authentifizierten Aufrufer nichts Sensibles zurückzuspielen. Wenn der Endpunkt Daten zurückgibt, auf die es ankommt, schützen Sie sie mit Authentifizierung.

Nächste Schritte