Les appels API de TrueLayer peuvent être effectués à la fois de manière synchrone et asynchrone.
Avantages du mode Async
- En général, les demandes asynchrones sont préférées pour limiter les problèmes indépendants de la volonté de TrueLayer.
- TrueLayer implémente automatiquement un mécanisme de répétition pour les appels asynchrones, pour que cela puisse supprimer le besoin d’écrire votre propre erreur et renouveler la tentative.
- L'API De Données (Data API) prend en charge les demandes asynchrones sur tous les endpoints (points de terminaison).
- Veuillez noter que le endpoint /token ne peut pas être implémenté de manière asynchrone.
Exécution d'une demande Async
- Transmettre un paramètre de requête async=true et un paramètre results_uri qui contiendra les résultats de votre demande une fois qu'ils sont disponibles.
- Après avoir fait un appel API asynchrone, vous pouvez obtenir le results_uri et attendre jusqu’à l’aboutissement.
Pour éviter de recueillir à chaque fois, vous pouvez transmettre un paramètre webhook_uri pour recevoir une notification en temps réel lorsque la demande est terminée via HTTP POST (Webhook).
Veuillez noter que même si webhook_uri transmet les résultats, ils ne feront pas partie de la charge utile HTTP POST mais doivent être récupérés à results_uri.
Lorsque les résultats seront prêts, ils seront disponibles pour être récupérer au results_uri.
La requête renvoie l'un des messages statut suivants :
| STATUT | DESCRIPTION |
|---|---|
| Queud (En file d’attente) | La requête est en attente d'exécution |
| Running (Fonctionnement) | La requête est en cours d'exécution |
| Succeeded (Réussi) | La requête a retourné les résultats avec succès |
| Failed (Échoué) | La requête a échouée à récupérer les résultats |
Par conséquent, une bonne pratique serait de demander le statut de la requête et récupérer les résultats seulement en cas de statut Réussi.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.