Vue d’ensemble des webhooks
Familiarisez-vous avec les webhooks et leur comparaison avec les API.
Vous pouvez configurer des webhooks pour recevoir des notifications en temps réel lorsque des événements se produisent au sein de votre organisation Juniper Mist ou d’un site Juniper Mist particulier.
Vous connaissez peut-être les webhooks sous le nom de rappels HTTP définis par l’utilisateur, de publications HTTP ou de notifications HTTP. Ces notifications incluent des détails sur les événements que vous pouvez utiliser dans vos propres applications ou dans des logiciels tiers.
Lorsque vous commencez à travailler avec des webhooks, il peut être utile de les comparer avec des API. Les API fonctionnent selon un modèle pull ou polling. Vous créez un appel d’API, et Juniper Mist répond avec les données demandées. En revanche, les webhooks fonctionnent sur un modèle push. Une fois que vous avez configuré un webhook, vous recevez des données au fur et à mesure que des événements se produisent.
Les webhooks d’organisation permettent de transférer les données en temps réel de l’organisation vers une URL fournie. Pour en savoir plus, consultez Webhooks d’organisation.
Les webhooks de site permettent d’envoyer des données en temps réel d’un site spécifique vers une URL fournie. Pour en savoir plus, consultez Webhooks de site.
| API REST | Webhooks | |
|---|---|---|
| Modèle | Modèle d’extraction ou d’interrogation | Modèle Push |
| Limite | 5 000 par organisation et par heure | Pas de limite |
| Opérations | Extraction de statistiques, création de configuration, mise à jour de la configuration | Alertes push et statistiques clés |
| Couverture | 100 % | Alertes, événements clés ou localisation |
| Cas d’usage recommandés | Automatisation, configuration | Intégration avec des outils de surveillance tiers ou des applications métiers |
Les concepts d’alertes et d’alarmes sont considérés comme interchangeables. Cependant, lors de la configuration d’une alerte, vous devez noter la syntaxe de l’alerte ou de l’alarme et utiliser ce qui est affiché.
Structure d’appel d’API pour les webhooks
Vous pouvez configurer des webhooks pour obtenir des données et des notifications en temps réel sur les événements qui se produisent au sein de votre organisation Mist ou d’un site particulier. Après avoir configuré un webhook, vous pouvez émettre un appel d’API dans lequel vous spécifiez un webhook particulier pour obtenir des données. L’image suivante est un exemple d’un tel appel d’API. L’appel spécifie le point de terminaison de l’API (préfixe), l’ID de l’organisation, la ressource (webhooks) et l’ID de webhook (a7c61a9c-a25b-4c27-xxxx-xxxxxxxxxxxx).
