Roboteka
Roboteka · Roboter · HTTP-Anfrage GET/POST

HTTP-Anfrage GET/POST

Der Roboter „HTTP-Anfrage GET/POST“ sendet eine Anfrage an eine externe API aus einem Geschäftsprozess heraus. Er akzeptiert eine URL, die Methode (GET, POST, PUT, PATCH, DELETE, HEAD), einen Anfragekörper, JSON-Header und ein Timeout und gibt den Antwortkörper, den HTTP-Statuscode und ein Erfolgskennzeichen (Y/N) zurück. Funktioniert in Geschäftsprozessen und Robotern von Bitrix24 (Alaio).

Der Roboter führt eine HTTP-Anfrage an eine externe API direkt aus einem Bitrix24 (Alaio)-Geschäftsprozess aus — ohne Code und ohne Zwischendienste. Unterstützt werden die Methoden GET, POST, PUT, PATCH, DELETE und HEAD, ein beliebiger Anfragekörper, Header als JSON (z. B. Authorization) und ein Timeout von 1 bis 60 Sekunden. Typische Fälle: Auftragsdaten an ein externes Buchhaltungssystem übergeben oder den Bestellstatus über die API eines Lieferdienstes abfragen. Weiterleitungen (bis zu 5) werden bei jedem Schritt geprüft, Anfragen an interne Netzwerkadressen werden blockiert, der Antwortkörper ist auf 1 MB begrenzt. Zurückgegeben werden Antwortkörper, HTTP-Statuscode und ein Erfolgskennzeichen (Y/N): Die Antwort lässt sich mit dem Roboter „Wert aus JSON per Pfad extrahieren“ auswerten, auf dem Kennzeichen bauen Sie im Workflow-Designer eine Bedingung auf. Läuft nicht, solange Bitrix24 im Demo-Modus ist.

Welche Eingabeparameter akzeptiert der Roboter?

Parameter Typ Pflichtfeld? Standard
URL string ja
HTTP-Methode (Standard GET) select GET, POST, PUT, PATCH, DELETE, HEAD — GET
Anfragekörper (für POST/PUT) string —
Header als JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} string —
Timeout in Sekunden (Standard 10) int —

Was gibt der Roboter zurück?

Parameter Typ
Antwortkörper string
HTTP-Statuscode int
Erfolgreich (Y/N) — 2xx-Code string

Welche Fehler kann der Roboter zurückgeben?

Diese Meldungen schreibt der Roboter ins Protokoll des Geschäftsprozesses, wenn er einen Schritt nicht ausführen kann. Der Text zeigt, was in den Einstellungen oder Daten zu korrigieren ist.

  • Fehler: Methode muss eine der folgenden sein: {methods}
  • Fehler: Header müssen ein JSON-Objekt sein
  • Fehler: ungültiger Header-Name: {name}
  • Fehler: Steuerzeichen sind im Header {name} nicht erlaubt
  • Fehler: Header {name} wird automatisch gesetzt
  • cURL-Fehler: {error}
  • Dieser Roboter läuft nicht, solange Bitrix24 im Demo-Modus ist oder der Tarif nicht ermittelt werden konnte.

Szenario: Bestellstatus bei einem externen Dienst abfragen

  1. Ein Auftrag wechselt in die Phase „Lieferung“ und startet den Roboter
  2. Der Roboter sendet eine GET-Anfrage mit der Bestellnummer an die API des Lieferdienstes
  3. Der Roboter „Wert aus JSON extrahieren“ holt den Status aus der Antwort
  4. Der Status wird in ein Feld des Auftrags geschrieben und ist für den Manager sichtbar

Ähnliche Roboter

Passende Artikel

Installieren Aufgabe beschreiben — wir bauen den Roboter kostenlos