Skip to content

HTTP-Anfrage (REST)

Dieser Service Task sendet eine HTTP-Anfrage an eine beliebige URL und gibt die Antwort zurück. Er fungiert als universeller REST-Connector innerhalb eines BPMN-Prozesses – ideal, um externe APIs aufzurufen, Webhooks auszulösen oder Daten von Drittdiensten abzurufen.

Nutzen: Externe Systeme können direkt in automatisierte Workflows eingebunden werden – ohne zusätzlichen Code.

Eingabeparameter

Parameter Typ Pflicht Beschreibung
url String Ja Die Ziel-URL (muss mit http:// oder https:// beginnen).
method String Nein HTTP-Methode: GET, POST, PUT, PATCH, DELETE. Standard: GET.
headers Objekt Nein Schlüssel-Wert-Paare als HTTP-Header (z. B. Authorization, Content-Type).
body Objekt / String Nein Anfragekörper. Objekte werden automatisch als JSON serialisiert. Wird bei GET ignoriert.
queryParams Objekt Nein Schlüssel-Wert-Paare, die als Query-Parameter an die URL angehängt werden.
timeout Zahl Nein Timeout in Millisekunden. Standard: 30 000. Maximum: 60 000.

Beispiel-Eingabe

{
  "url": "https://api.example.com/orders",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer {{token}}",
    "Content-Type": "application/json"
  },
  "body": {
    "orderId": "2024-001",
    "status": "confirmed"
  },
  "timeout": 10000
}

Ausgabe

Feld Typ Beschreibung
statusCode Zahl Der HTTP-Statuscode der Antwort (z. B. 200, 404, 500).
body Objekt / String Antwortinhalt. Wird automatisch als JSON geparst, wenn möglich; andernfalls als Klartext zurückgegeben.
headers Objekt Antwort-Header als Schlüssel-Wert-Paare.

Beispiel-Ausgabe

{
  "statusCode": 200,
  "body": {
    "success": true,
    "message": "Order confirmed"
  },
  "headers": {
    "content-type": "application/json"
  }
}

Verhalten und Einschränkungen

  • Nur http- und https-Protokolle werden unterstützt.
  • Die maximale Antwortgröße beträgt 5 MB. Größere Antworten führen zu einem Fehler.
  • Wird ein Objekt als Body übergeben und kein Content-Type-Header gesetzt, wird automatisch application/json ergänzt.
  • Der Antwortinhalt wird nach Möglichkeit als JSON geparst; andernfalls wird der Rohtext zurückgegeben.
  • Netzwerkfehler oder Timeouts führen zu einem Prozessfehler – sie werden nicht stillschweigend ignoriert.

Anwendungsfälle

  • Webhook auslösen, wenn ein Prozessschritt abgeschlossen wird.
  • Datensätze anlegen oder aktualisieren in einem externen CRM- oder ERP-System.
  • Echtzeitdaten abrufen (z. B. Wechselkurse, Wetter, Lagerbestände) für nachgelagerte Entscheidungen.
  • Externe Tools benachrichtigen (Slack, Teams, E-Mail-APIs) über Prozessereignisse.
  • Microservices verketten innerhalb eines BPMN-Workflows.