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.