Webhooks et événements
Un webhook est un service de notification systémique qui permet une intégration asynchrone entre systèmes — Unico IDCloud notifie votre backend à chaque changement d'état d'un processus, vous évitant ainsi d'avoir à interroger les mises à jour.
Cette section couvre les quatre éléments nécessaires à l'intégration des webhooks : comment configurer le point de terminaison et l'authentification, les événements envoyés par Unico, la stratégie de repli et les modèles de sécurité et fiabilité que votre point de terminaison doit implémenter.
Quand utiliser les webhooks
Les webhooks sont la méthode recommandée pour être notifié de l'achèvement d'un processus. Ils sont particulièrement pertinents pour :
- Human Token Journey (
humantoken,humantoken+revalidation) — pour être notifié lorsque l'utilisateur termine le parcours d'un processus créé avec Créer un processus. Les webhooks ne se déclenchent qu'à l'état terminal (PROCESS_STATE_FINISHED) ; aucun événement de progression intermédiaire n'est envoyé. - Flux API Only (
api+humantoken,api+liveness+humantoken,api+liveness+humantoken+revalidation) — le résultat arrive déjà dans la réponse de Créer un processus, ces flux ne dépendent donc pas du webhook.
Les webhooks complètent, sans remplacer, les points de terminaison GetProcess. Voir Repli.
Dans cette section
- Configuration — enregistrement du point de terminaison, méthodes d'authentification (OAuth2, Basic, API Key), paramètres de nouvelle tentative.
- Types d'événements — les événements envoyés par Unico et la structure de la charge utile.
- Sécurité — idempotence, limite de simultanéité et taux d'erreur.
- Repli — comment récupérer le résultat du processus lorsque le webhook est indisponible.