Senden Sie eine HTTP-Anforderung an einen beliebigen Endpunkt während einer Automatisierungsausführung. Verwenden Sie diese Aktion, um Level-Automatisierungen mit externen Systemen zu integrieren — lösen Sie Webhooks aus, posten Sie Daten an eine API, oder rufen Sie einen beliebigen HTTP-Endpunkt als Teil eines Workflows auf.
HTTP-Anforderungsaktion
Klicken Sie im Pipeline-Bearbeitungsmodus auf + und wählen Sie HTTP-Anforderung aus der Kategorie Sonstige.
URL
Der Endpunkt, an den die Anforderung gesendet werden soll. Erforderlich. Klicken Sie auf (x), um eine Variable, Systemvariable oder einen Verweis auf ein benutzerdefiniertes Feld einzufügen.
Beispiel : https://hooks.example.com/services/webhook
Methode
Die HTTP-Methode für die Anforderung.
Unterstützte Methoden : GET, POST, PUT, DELETE, PATCH.
Inhaltstyp
Der Inhaltstyp des Anforderungstexts.
Option | Verwendung |
| JSON-Lasten |
| Nur-Text |
| Formularübermittlungen |
Text
Der Anforderungstext. Klicken Sie auf (x), um Variablenverweise einzufügen, um dynamische Daten aus dem Pipeline einzuschließen.
Header
Klicken Sie auf + Anforderungs-Header hinzufügen, um benutzerdefinierte Schlüssel-Wert-Header-Paare hinzuzufügen. Klicken Sie auf (x) in einem der Felder, um einen Variablenverweis einzufügen. Klicken Sie auf ×, um eine Header-Zeile zu entfernen.
Häufige Header :
Authorization: Bearer ##{{api_token}}X-API-Key: ##{{api_key}}
Bedingungen
Mit der Aktion Bedingungen können Sie den Zeitpunkt der Ausführung dieser Aktion basierend auf Geräteattributen oder dem Ergebnis einer vorherigen Aktion einschränken.
Siehe Aktionsbedingungen für die vollständige Referenz zu Bedingungstypen, Operatoren und Werten.
Zusätzliche Optionen
Erweitern Sie Zusätzliche Optionen für den Aktionsnamen, das Fehlerverhalten, die Zuweisung von Ausgabevariablen, Versuchen und den Aktivierungsschalter.
💡 TIPP : Verwenden Sie Aktionsausgabe einer Variable zuweisen in den zusätzlichen Optionen, um den HTTP-Antwortkörper in einer Automatisierungsvariable zu erfassen. Dies ermöglicht es nachfolgenden Aktionen, auf die Antwort zu reagieren — zum Beispiel durch Überprüfung eines von einer API zurückgegebenen Statusfelds.
Siehe Aktionsübersicht für die vollständige Referenz zu zusätzlichen Optionen, die für jede Aktion verfügbar sind.
FAQ
Was zählt als erfolgreiche Anforderung? Eine Anforderung wird als erfolgreich erachtet, wenn der Endpunkt einen 2xx HTTP-Antwortcode zurückgibt. Jede Nicht-2xx-Antwort (4xx oder 5xx) wird als Fehler behandelt und die Aktion wird als fehlgeschlagen markiert.
Kann ich JSON in den Text einfügen? Ja — setzen Sie
Content-Type: application/jsonin der Header-Sektion und schreiben Sie Ihre JSON-Last in das Text-Feld.Kann ich mich an einem geschützten Endpunkt authentifizieren? Ja — fügen Sie einen
Authorization-Header mit Ihrem Token oder Ihren Anmeldedaten ein. Verwenden Sie (x), um eine gespeicherte Automatisierungsvariable oder ein benutzerdefiniertes Feld zu referenzieren, anstatt den Wert fest zu codieren.Wer kann HTTP-Anforderungsaktionen hinzufügen oder ändern? Techniker mit Berechtigung zum Bearbeiten von Automatisierungen in der relevanten Gruppe. Weitere Informationen zur Zugriffskontrolle finden Sie unter Arbeitsbereich → Berechtigungen.