Erstellen von Webhooks über die API
Befolgen Sie diese Anweisungen, um einen POST-Befehl zum Einrichten eines neuen Webhooks zu verwenden.
Verwenden Sie ein POST
, um einen Webhook zu konfigurieren und Themen zu aktivieren.
Beachten Sie in Ihrem API-Aufruf die Konfigurationshierarchie und die verschiedenen Themen, die für Organisationen und Standorte verfügbar sind.
-
Stellen Sie sicher, dass Sie in der API-Funktion die Organisations-ID oder Standort-ID angeben. Weitere Informationen finden Sie unter Konfigurieren von Webhooks über die API.
-
Achten Sie darauf, dass Sie in der
topics
Zeile nur die Themen angeben, die für die Organisations- oder Standortebene geeignet sind. Weitere Informationen finden Sie unter Webhook-Themen.
Im Folgenden finden Sie ein Beispiel für die POST
Konfiguration eines Websitewebhooks, um Themen auf Websiteebene zu aktivieren:
Die Beispielstruktur POST
finden Sie unter Erstellen eines Website-Webhooks. Siehe ggf. auch Erstellen eines Webhooks für die Organisation. Im Folgenden finden Sie eine Beispielantwort.
{ "name": "analytic", "type": "http-post", "url": "https://username:password@hooks.abc.com/uri/...", "secret": "secret", "headers":{ "x-custom-1": "your_custom_header_value1", "x-custom-2": "your_custom_header_value2" }, "verify_cert": false, "enabled": true, "topics": [ "location", "zone", "vbeacon", "rssizone", "asset-raw-rssi", "device-events", "alarms", "audits", "client-join", "client-sessions", "device-updowns", "occupancy-alerts", "mxedge-events", "nac-accounting", "sdkclient-scan-data",] }
Ersetzen Sie bei der Wiederverwendung von Codeblöcken Platzhalterwerte durch tatsächliche Werte, z. B. Ihr API-Token, Ihre Unternehmens-ID, Ihre Standort-ID, Ihren AP-Namen usw.
Parameter |
Beschreibung |
---|---|
Name |
Der Name des konfigurierten Webhooks. |
Art |
Die Art des Webhooks (http-post, splunk usw.). |
URL |
Das Ziel, an dem der Webhook empfangen werden soll. |
geheim |
Bei Verwendung des |
Header |
Benutzerdefinierte Header können unter der |
verify_cert |
Gibt an, ob die Zertifikatsüberprüfung aktiviert ist. Wahr oder falsch. |
ermöglichte |
Gibt an, ob der Webhook aktiviert ist oder nicht. Wahr oder falsch. |
Themen |
Die ausgewählten Elemente, für die Sie Nachrichten oder Warnungen erhalten möchten. Weitere Informationen finden Sie unter Webhook-Themen. Weitere Informationen finden Sie auch in den Webhook-Themen der Mist-API-Referenz. |
Siehe auch Sichern von Webhooks mit dem Splunk-Typ.