WebHooks

Un WebHook est un mécanisme qui permet de notifier, via une requête HTTP(S), un système externe de la survenue d'un évènement. Il s'agira donc d'évènements qui se produisent dans l'application CARL Source.

Ces évènements sont essentiellement des évènements simples sur les entités : création, modification, ou suppression d'une entité.

Techniquement les WebHooks de CARL Source n'exécutent pas une requête HTTP pour chaque évènement de chaque entité.

Pour des raisons de performance (éviter de multiplier le nombre de requêtes HTTP), les notifications sont faites par transaction métier.
C'est à dire que si, dans une transaction métier, plusieurs entités sont modifiées, une seule requête HTTP sera émise. Elle décrira alors l'ensemble des évènements de chaque entité modifiée au cours de cette transaction.

Dans CARL Source, deux types de WebHook peuvent être utilisés :

Entités : il s'agit d'un WebHook classique qui permet de notifier un système externe en envoyant une description de l'évènement via une requête HTTP POST avec un contenu au format JSON.

ArcGIS : il s'agit d'un WebHook spécifique permettant d'envoyer les évènements vers un serveur de cartographie ArcGIS dans un format adapté de façon à synchroniser les données de CARL Source avec ce serveur.