Einführung

Sendet eine HTTP-Anfrage an einen beliebigen Endpunkt während eines Automatisierungsdurchlaufs. Verwenden Sie diese Aktion, um Level-Automatisierungen mit externen Systemen zu integrieren – Webhooks auslösen, Daten an eine API senden oder einen beliebigen HTTP-Endpunkt als Teil eines Workflows aufrufen.

HTTP-Anfrage-Aktion

Wenn der Canvas noch keine Aktionen enthält, wählen Sie Eine Aktion hinzufügen. Um diesen Schritt zu einem Canvas hinzuzufügen, der bereits Aktionen enthält, klicken Sie auf das inline + an der gewünschten Stelle aus und wählen Sie Eine weitere Aktion hinzufügen. Wählen Sie dann HTTP-Anfrage aus der Sonstige Kategorie.

URL

Der Endpunkt, an den die Anfrage gesendet werden soll. Erforderlich. Klicken Sie auf (x) um eine Variable, Systemvariable oder einen benutzerdefinierten Feldbezug einzufügen.

Beispiel: https://hooks.example.com/services/webhook

Methode

Die HTTP-Methode für die Anfrage.

Unterstützte Methoden: GET, POST, PUT, DELETE, PATCH.

Inhaltstyp

Der Inhaltstyp des Anfragetexts.

Option	Verwendung
`application/json`	JSON-Nutzdaten
`text/plain`	Nur-Text
`application/x-www-form-urlencoded`	Formularübermittlungen

Inhalt

Der Anfragetext. Klicken Sie auf (x) um Variablenreferenzen einzufügen und dynamische Daten aus der Pipeline einzubinden.

Kopfzeilen

Klicken Sie auf + Anfrage-Kopfzeilen hinzufügen um benutzerdefinierte Schlüssel-Wert-Kopfzeilenpaare hinzuzufügen. Klicken Sie auf (x) in einem der Felder, um eine Variablenreferenz einzufügen. Klicken Sie auf × um eine Kopfzeilenzeile zu entfernen.

Häufige Kopfzeilen:

Authorization: Bearer {{api_token}}
X-API-Key: {{api_key}}

Bedingungen

Der Bedingungen Abschnitt ermöglicht es Ihnen, die Ausführung dieser Aktion anhand von Geräteattributen oder dem Ergebnis einer vorherigen Aktion einzuschränken.

Siehe Aktionsbedingungen für die vollständige Referenz zu Bedingungstypen, Operatoren und Werten.

Zusätzliche Optionen

Erweitern Sie Zusätzliche Optionen für Aktionsname, Fehlerverhalten, Ausgabevariablenzuweisung, Wiederholungen und den Aktiviert-Schalter.

💡 TIPP: Verwenden Sie Aktionsausgabe einer Variable zuweisen in den Zusätzlichen Optionen, um den HTTP-Antworttext in einer Automatisierungsvariable zu speichern. Dadurch können nachfolgende Aktionen auf die Antwort reagieren – zum Beispiel ein Statusfeld prüfen, das von einer API zurückgegeben wird.

Siehe Aktionsübersicht für die vollständige Referenz zu zusätzlichen Optionen, die für jede Aktion verfügbar sind.

Häufig gestellte Fragen

Was gilt als erfolgreiche Anfrage? Eine Anfrage gilt als erfolgreich, wenn der Endpunkt einen 2xx-HTTP-Antwortcode. Jede Nicht-2xx-Antwort (4xx oder 5xx) wird als Fehler gewertet und die Aktion wird als fehlgeschlagen markiert.
Kann ich JSON im Anfragetext senden? Ja – setzen Sie Content-Type: application/json im Abschnitt „Kopfzeilen" und schreiben Sie Ihre JSON-Nutzdaten in das Textfeld.
Kann ich mich bei einem geschützten Endpunkt authentifizieren? Ja – fügen Sie eine Authorization Kopfzeile mit Ihrem Token oder Ihren Anmeldedaten. Verwenden Sie (x) um auf eine gespeicherte Automatisierungsvariable oder ein benutzerdefiniertes Feld zu verweisen, anstatt den Wert fest zu kodieren.
Wer kann HTTP-Anfrage-Aktionen hinzufügen oder ändern? Techniker mit der Berechtigung, Automatisierungen in der jeweiligen Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen zur Konfiguration der Zugriffskontrolle.

Verwandte Artikel