...
une exposition via plusieurs URL, avec un masquage du service web appelé
une exposition de préférence différenciée par appelant
des fonctionnalités réduites sont accessibles
les fonctionnalités sont exploitées par une URL longue avec paramètres et un aucun message
le traitement métier doit être rapide et simple, synchrone, avec peu de volume de données
l’objectif principal est de faire un lien d’accroche d’informations
Le webhook doit donc en principe permettre à une application externe de transmettre des informations, dans le sens “d’un fil d’informations continu synchrone” de l’appelant vers l’appelé, quitte à ce que cela déclenche un appel en retour vers l’appelant pour demander plus d’informations de manière asynchrone.
Paramétrer un WebHook
...
Astuce |
---|
Le WebHook est un autre mode d'exposition d’un service web. Tout la mise en oeuvre des services web SOAP ou REST et d’une action de service sont donc requis au préalable. |
Paramétrer un WebHook
Info |
---|
Il faut au préalable avoir créé le service web que l’on souhaite appeler, en mode SOAP ou REST, et de préférence avoir vérifié qu’il est opérationnel avant de l’appeler en mode WebHook |
A partir du zoom des actions de service web (Harmony / Paramétrage / Actions des services ou ERP : Administration / Paramètres / Action des services), une fois placé sur la ligne du service web pour lequel on souhaite créer un WebHook, cliquez sur le bouton “Appel du zoom webhook”
Le zoom des WebHook présente la liste des WebHooks avec les informations suivantes:
Code WebHook : c’est une clé (chaîne de caractères) qui peut être saisie ou générée lors de la création. C’est l'élément indispensable pour l’appelant et la constitution de l’URL à appeler
Active / Inactif : permet d’inactiver un WebHook
Action : code de l’action de service web, en lien avec le zoom des actions de service web. L’existence du service web est donc un pré-requis.
Paramètres HMP : non utilisé en standard. Permet de donner des paramètres supplémentaires au traitement appelé
Code Appelant : code permettant de distinguer l’appelant, lorsque plusieurs WebHook exposent le même service web
Lors de la création, le code WebHook peut être saisi ou généré par le bouton “Créer un webhook”. Cette clé ne sera plus modifiable par la suite
...
Comment appeler un WebHook
...