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
topicsZeile 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.