Skip To Content

Concepts clés relatifs aux webhooks

Un webhook fournit à d’autres applications des informations liées à des événements ; ces informations sont livrées sous forme de requête HTTPS qui permet de créer des processus d’intégration automatisés. Certains des concepts clés liés aux processus de ArcGIS Enterprise sont décrits de manière détaillée dans les sections qui suivent.

Déclencheur d’événement

Un déclencheur d’événement spécifie les opérations d’API qui appellent le webhook. Les webhooks d’organisation et de service d’entités prennent en charge différents déclencheurs d’événement auxquels vous pouvez vous abonner. Vous pouvez ainsi définir le déclenchement d’un webhook d’organisation à la mise à jour d’un groupe spécifique ou le déclenchement d’un webhook de service d’entités à la mise à jour de la définition du service d’entités. Les webhooks de service de géotraitement n’utilisent pas de liste de déclencheurs d’événement auxquels les utilisateurs peuvent s’abonner. Les webhooks de service de géotraitement renvoient des charges utiles une fois qu’une tâche de service de géotraitement est terminée. Pour plus d’informations sur la liste des déclencheurs d’événement des webhooks d’organisation et de service d’entités, reportez-vous à la rubrique Déclencheurs d’événement.

Charge utile

Lorsqu’un utilisateur effectue une opération spécifiée en tant que déclencheur d’événement, le webhook livre les informations liées à l’événement, également désignées sous le terme de charge utile, à l’URL de charge utile indiquée. Les informations liées à l’événement de chaque type de webhook sont livrées dans une structure JSON similaire qui contient les informations liées à l’événement, ainsi que le moment auquel il s’est produit ; cependant, la structure et les propriétés de charge utile renvoyées pour les webhooks d’organisation et de service varient selon le type de webhook. Pour en savoir plus sur les charges utiles de chaque type de webhook, reportez-vous à la rubrique Charges utiles.

URL de charge utile

Lorsqu’un webhook est appelé, la charge utile est livrée à une URL spécifique, souvent fournie par le récepteur de webhook. L’URL de charge utile est indiquée lors de la configuration du webhook ; sa vérification à la création permet de s’assurer que le récepteur est accessible par ArcGIS Enterprise via une requête HTTPS POST.

Récepteurs

Les charges utiles sont livrées aux récepteurs de webhook, qui extraient la charge utile et indiquent que l’événement s’est produit aux administrateurs ou aux membres de l’organisation. Les récepteurs de webhook doivent être configurés pour communiquer via une connexion HTTPS afin de recevoir des charges utiles et être accessibles par ArcGIS Enterprise. Quelques options sont prises en charge pour les récepteurs, tels que les récepteurs de service Web tiers (Microsoft Power Automate, Zapier et IFFT), les services Web personnalisés, ArcGIS Notebook Server et ArcGIS Workflow Manager. Pour accéder à des exemples de création de services Web personnalisés ou vous familiariser avec les récepteurs tiers, reportez-vous à la rubrique Référentiel de webhook. Pour en savoir plus sur la création de webhooks Notebook Server et Workflow Manager, reportez-vous aux rubriques Automatiser les processus avec ArcGIS Notebooks et Créer des tâches avec des webhooks, respectivement.