Configurer des webhooks

Les administrateurs de l’organisation peuvent gérer les webhooks pour toute couche d’entités hébergée, vue de couche d’entités hébergée ou table hébergée éligible dans l’organisation.

L’infrastructure de prise en charge des webhooks est configurée en dehors d’ArcGIS. Pour savoir ce que vous devez configurer avant de créer un webhook et découvrir les privilèges requis pour gérer les webhooks, consultez Webhooks dans ArcGIS Online.

Le paramètre de mise à jour Keep track of changes to the data (add, update, delete features) (Conserver un suivi des modifications des données [ajout, mise à jour et suppression d’entités]) doit être activé pour l’élément avant de créer ou de gérer un webhook à son intention.

Gérer les webhooks

La gestion d’un webhook associé à une couche d’entités hébergée, une vue de couche d’entités hébergée ou une table hébergée inclut les étapes suivantes :

• Désactiver ou activer le webhook : lorsqu’un webhook est inactif, il ne démarre pas lorsque les événements déclencheurs définis pour lui se produisent. Vous pouvez désactiver temporairement tous les webhooks d’une couche pendant que vous réalisez des mises à jour automatiques afin d’éviter de saturer votre boîte de réception. Vous pouvez également désactiver temporairement un webhook qui démarre pour tous les événements possibles et laisser un autre webhook actif qui démarre sur un seul déclencheur afin de vous concentrer temporairement sur l’événement en question.
• Modifier le webhook : vous pouvez modifier les paramètres du webhook. Vous pouvez par exemple ajouter une clé secrète ou modifier les déclencheurs d’événements qui entraînent le démarrage du webhook.
• Supprimer le webhook : si un webhook n’est plus requis, vous pouvez le supprimer.

  Remarque :

  Les webhooks sont immédiatement supprimés. Ils ne sont pas déplacés dans la corbeille.

Pour gérer des webhooks dans l’organisation, procédez comme suit :

1. Connectez-vous à l’organisation en tant qu’administrateur de l’organisation.

   Comme indiqué ci-dessus, consultez Webhooks dans ArcGIS Online pour connaître les privilèges requis.

2. Cliquez sur Organization (Organisation) > Settings (Paramètres) > Webhooks.
3. Effectuez l’une des opérations de gestion suivantes :
   • Pour désactiver le webhook, désactivez le bouton bascule en regard de son nom.
   • Pour activer le webhook, activez le bouton bascule en regard de son nom.
   • Pour modifier les paramètres d’un webhook, cliquez sur le bouton Options en regard de son nom et sur Edit (Modifier). Modifiez le nom, les événements, l’URL de récepteur webhook ou la clé secrète du webhook, puis cliquez sur Update webhook (Mettre à jour le webhook).
   • Pour supprimer un webhook, cliquez sur le bouton Options en regard de son nom et sur Delete (Supprimer). À l’invite de confirmation, cliquez sur Delete (Supprimer).
4. Exécutez à nouveau l’étape précédente pour tout webhook que vous devez gérer.

Configurer les paramètres avancés

Les paramètres avancés appliqués aux webhooks dans votre organisation vous permettent de personnaliser davantage leurs performances.

Les paramètres de webhook avancés s’appliquent à tous les webhooks dans l’organisation. Vous pouvez configurer les paramètres avancés suivants :

• Number of delivery attempts (Nombre de tentatives de livraison) : cette valeur spécifie le nombre de tentatives de livraison des charges utiles des webhooks. Par défaut, le système effectue une tentative de livraison des charges utiles. Le nombre de tentatives doit être un entier compris entre 1 et 5.
• Notification timeout (Délai d’expiration des notifications) : cette valeur spécifie l’intervalle, en secondes, entre chaque tentative de livraison des charges utiles. Par défaut, le système effectue une tentative de livraison d’une autre charge utile au bout de 10 secondes en cas d’échec de la tentative précédente, jusqu’à ce que le nombre de tentatives spécifié dans Number of delivery attempts (Nombre de tentatives de livraison) soit atteint. La valeur de Notification timeout (Délai d’expiration des notifications) doit être un entier compris entre 1 et 10.
• Maximum number of failures (Nombre maximal d’échecs) : cette valeur spécifie le nombre d’échecs qui peuvent se produire au cours d’un nombre spécifique de jours avant la désactivation du webhook. Par défaut, le système accepte 5 échecs. La valeur doit être un entier compris entre 1 et 10.

1. Connectez-vous à l’organisation en tant qu’administrateur de l’organisation.

   Comme indiqué ci-dessus, consultez Webhooks dans ArcGIS Online pour connaître les privilèges requis.

2. Cliquez sur Organization (Organisation) > Settings (Paramètres) > Webhooks.
3. Cliquez sur Advanced settings (Paramètres avancés).
4. Changez les valeurs des paramètres avancés comme décrit précédemment, si nécessaire.
5. Cliquez sur Save (Enregistrer).