Einführung
Senden Sie eine HTTP-Anfrage an einen beliebigen Endpunkt während eines Automatisierungslaufs. 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
Klicken Sie in der Automatisierungspipeline im Bearbeitungsmodus auf + und wählen Sie HTTP-Anfrage 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 Feldreferenz einzufügen.
Methode
Die HTTP-Methode für die Anfrage.
Unterstützte Methoden: GET, POST, PUT, DELETE, PATCH.
Inhaltstyp
Der Inhaltstyp des Anfragetexts.
Option | Verwendung |
| JSON-Nutzdaten |
| Nur-Text |
| Formularübermittlungen |
Anfragetext
Der Anfragetext. Klicken Sie auf (x) um Variablenreferenzen einzufügen und dynamische Daten aus der Pipeline einzubeziehen.
Header
Klicken Sie auf + Anfrage-Header hinzufügen um benutzerdefinierte Schlüssel-Wert-Headerpaare hinzuzufügen. Klicken Sie auf (x) in einem der Felder, um eine Variablenreferenz einzufügen. Klicken Sie auf × um eine Headerzeile zu entfernen.
Häufige Header:
Authorization: Bearer {{api_token}}X-API-Key: {{api_key}}
Bedingungen
Der Bedingungen Abschnitt ermöglicht es Ihnen, einzuschränken, wann diese Aktion ausgeführt wird – basierend auf Geräteattributen oder dem Ergebnis einer vorherigen Aktion.
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, Wiederholungsversuche und den Aktivierungsschalter.
💡 TIPP: Verwenden Sie Aktionsausgabe einer Variable zuweisen in den „Zusätzlichen Optionen", um den HTTP-Antworttext in eine Automatisierungsvariable zu übernehmen. So können nachfolgende Aktionen auf die Antwort reagieren – zum Beispiel, um ein Statusfeld zu prüfen, das von einer API zurückgegeben wurde.
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/jsonim Abschnitt „Header" und schreiben Sie Ihre JSON-Nutzdaten in das Feld „Anfragetext".Kann ich mich bei einem geschützten Endpunkt authentifizieren? Ja – fügen Sie einen
AuthorizationHeader mit Ihrem Token oder Ihren Anmeldedaten. Verwenden Sie (x) um auf eine gespeicherte Automatisierungsvariable oder ein benutzerdefiniertes Feld zu verweisen, anstatt den Wert fest einzutragen.Wer kann HTTP-Anfrage-Aktionen hinzufügen oder ändern? Techniker mit der Berechtigung, Automatisierungen in der jeweiligen Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen für die Konfiguration der Zugriffskontrolle.