Webhooks des plugins
Transmettez des événements extérieurs à un plugin activé dans votre organisation, et ce que l'endpoint vérifie avant que le plugin ne les voie.
Un plugin qui déclare la capacité webhook reçoit les événements extérieurs à l'adresse :
POST https://intelligence-api.veyra.so/api/plugins/{pluginId}/webhooks/{endpointKey}endpointKey désigne l'un des endpoints que le plugin déclare dans son manifeste. La page de réglages du plugin affiche ses adresses.
Ce que Veyra vérifie d'abord
| Vérification | En cas d'échec |
|---|---|
| Le plugin existe. | 404 |
| Le plugin est prêt (activé et démarré). | 400 avec son statut actuel |
| Le plugin déclare la capacité webhook et cet endpoint. | 400 ou 404 |
Le plugin vérifie ensuite la requête à sa manière (par exemple une signature du service émetteur) et décide de ce qu'il en fait. Sa documentation décrit la charge utile attendue.
Authentification
La façon dont un webhook de plugin est authentifié dépend du plugin. Préférez les plugins qui vérifient une signature de l'émetteur ; l'adresse de l'endpoint seule ne doit pas être considérée comme un secret.
Voir Plugins dans la référence de l'API.