Einführung
Sende eine HTTP-Anfrage an einen beliebigen Endpunkt während einer Automatisierungsausführung. Verwende 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
Klicke in der Automatisierungspipeline im Bearbeitungsmodus auf + und wähle HTTP-Anfrage aus der Kategorie „Sonstiges".
URL
Der Endpunkt, an den die Anfrage gesendet wird. Erforderlich. Klicke 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 |
Hauptteil
Der Anfragetext. Klicke auf (x) um Variablenreferenzen einzufügen und dynamische Daten aus der Pipeline einzubinden.
Kopfzeilen
Klicke auf + Anfrage-Kopfzeilen hinzufügen um benutzerdefinierte Schlüssel-Wert-Kopfzeilenpaare hinzuzufügen. Klicke auf (x) in einem der Felder, um eine Variablenreferenz einzufügen. Klicke 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 dir, einzuschränken, wann diese Aktion ausgeführt wird – basierend auf Geräteattributen oder dem Ergebnis einer vorherigen Aktion.
Siehe Aktionsbedingungen die vollständige Referenz zu Bedingungstypen, Operatoren und Werten.
Zusätzliche Optionen
Erweitere Zusätzliche Optionen für Aktionsname, Fehlerverhalten, Ausgabevariablenzuweisung, Wiederholungsversuche und den Aktivierungsschalter.
💡 TIPP: Verwende Aktionsausgabe einer Variable zuweisen unter „Zusätzliche Optionen", um den HTTP-Antworttext in eine Automatisierungsvariable zu erfassen. Dadurch können nachfolgende Aktionen auf die Antwort reagieren – zum Beispiel das Prüfen eines Statusfelds, das von einer API zurückgegeben wurde.
Siehe Aktionsübersicht die vollständige Referenz zu den zusätzlichen Optionen, die für jede Aktion verfügbar sind.
Häufig gestellte Fragen
Was zählt 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 Hauptteil senden? Ja – setze
Content-Type: application/jsonim Bereich „Kopfzeilen" und schreibe deine JSON-Nutzdaten in das Feld „Hauptteil".Kann ich mich bei einem geschützten Endpunkt authentifizieren? Ja – füge eine
AuthorizationKopfzeile mit deinem Token oder deinen Anmeldedaten. Verwende (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 entsprechenden Gruppe zu bearbeiten. Siehe Arbeitsbereich → Berechtigungen zur Konfiguration der Zugriffssteuerung.