Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

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.

Anmerkung:

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.

Tabelle 1: Beschreibungen der Webhook-Parameter

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 http-post Webhook-Typs wird das Geheimnis von der Juniper Mist Cloud zum Signieren der Webhook-Nachricht verwendet. Siehe auch Der geheime Parameter.

Header

Benutzerdefinierte Header können unter der headersEigenschaft hinzugefügt werden. Diese benutzerdefinierten Header werden den HTTP-Headern hinzugefügt, die von der Juniper Mist Cloud zur Authentifizierung gesendet werden. Weitere Informationen finden Sie ggf. unter apiToken (benutzerdefinierte Headersignatur) und csrfToken (benutzerdefinierte Headersignatur).

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.