Stratégie de repli
En cas d'indisponibilité du service webhook, il est recommandé d'implémenter un mécanisme de repli pour garantir que votre application puisse récupérer le résultat du processus dans le délai de réponse attendu.
Fonctionnement
Le webhook est le mécanisme principal de livraison des résultats. Cependant, vous devez traiter les signaux suivants comme des déclencheurs supplémentaires pour récupérer activement le résultat via GET /client/v1/process/{processId} :
| Signal | Canal | Ce qu'il fournit |
|---|---|---|
Callback onFinish | SDK Web / WebMobile | Signal de fin de parcours — sans résultat |
Redirection callbackUri | Tous les autres canaux | Redirection URL uniquement — sans résultat |
Ni onFinish ni callbackUri ne transmettent directement le résultat du processus. Ce sont uniquement des signaux de fin de parcours. Votre back-end est responsable de la corrélation entre l'id reçu (ou la redirection) et le processId précédemment stocké, puis d'appeler GetProcess pour récupérer le résultat réel.
Flux recommandé
Dès réception d'un signal de fin de parcours, votre back-end doit appeler GET /client/v1/process/{processId} et valider le résultat dans l'ordre suivant :
- Confirmer
state = PROCESS_STATE_FINISHED - Évaluer le champ
resultet appliquer vos règles métier
Cela garantit qu'une indisponibilité temporaire du webhook n'entraîne pas la perte des résultats du processus.