Einführung
Senden Sie eine HTTP-Anfrage an einen beliebigen Endpunkt während der Automatisierungsausführung. Verwenden Sie diese Aktion, um Level-Automatisierungen mit externen Systemen zu integrieren — Webhooks auslösen, Daten an eine API senden oder beliebige HTTP-Endpunkte als Teil eines Workflows aufrufen.
HTTP-Anforderungsaktion
Klicken Sie in der Automatisierungs-Pipeline im Bearbeitungsmodus auf + and select HTTP request aus der Kategorie Sonstiges.
URL
Der Endpunkt, an den die Anfrage gesendet werden soll. Erforderlich. Klicken Sie auf (x) um eine Variable, Systemvariable oder einen benutzerdefinierten Feldverweis einzufügen.
Methode
Die HTTP-Methode für die Anfrage.
Unterstützte Methoden: GET, POST, PUT, DELETE, PATCH .
Inhaltstyp
Der Inhaltstyp des Anfragetexts.
Option | Verwenden |
| JSON payloads |
| Plain text |
| Formulareinreichungen |
Body
Der Anfrageinhalts. Klicken Sie auf (x) um Variablenverweise einzufügen, um dynamische Daten aus der Pipeline einzuschließen.
Header
Click + Anfragekopfzeilen hinzufügen um benutzerdefinierte Schlüssel-Wert-Kopfzeilenpaare hinzuzufügen. Klicken Sie auf (x) in beiden Feldern, um einen Variablenverweis einzufügen. Klicken Sie auf × um eine Kopfzeilenkopie zu entfernen.
Common headers:
Authorization: Bearer ##{{api_token}}X-API-Key: ##{{api_key}}
Conditions
Das Feld Conditions Mit dem Abschnitt können Sie einschränken, wann diese Aktion ausgeführt wird, basierend auf Geräteattributen oder dem Ergebnis einer vorherigen Aktion.
See Aktionsbedingungenfü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 Umschalter aktiviert.
💡 TIP: Use Aktionsausgabe der Variablen zuweisen unter Zusatzoptionen, um den HTTP-Antwortkörper in einer Automatisierungsvariable zu erfassen. Dies ermöglicht nachfolgenden Aktionen, auf die Antwort einzuwirken — beispielsweise durch Überprüfung eines von einer API zurückgegebenen Statusfelds.
See Aktionsübersichtfür die vollständige Referenz der 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 zurückgibt 2xx HTTP-Antwortkode . Any Nicht-2xx-Antwort (4xx oder 5xx) wird als Fehler behandelt und die Aktion wird als fehlgeschlagen markiert.
Kann ich JSON im Körper senden? Yes — set
Content-Type: application/jsonim Abschnitt Kopfzeilen und schreiben Sie Ihre JSON-Nutzlast in das Feld Körper.Kann ich mich bei einem geschützten Endpunkt authentifizieren? Ja — fügen Sie a hinzu
AuthorizationKopfzeile mit Ihrem Token oder Ihren Anmeldedaten. Verwenden Sie(x) um auf eine gespeicherte Automatisierungsvariable oder ein benutzerdefiniertes Feld zu verweisen, anstatt den Wert hart zu codieren.Wer kann HTTP-Request-Aktionen hinzufügen oder ändern? Techniker mit Berechtigung zum Bearbeiten von Automatisierungen in der relevanten Gruppe. Siehe Arbeitsbereich → Berechtigungen für die Konfiguration der Zugriffskontrolle.