Las solicitudes a la API de TrueLayer se pueden hacer de manera Síncrona (Sync) y Asíncrona. (Async).
Ventajas de Async
- Async suele ser la preferida dado que puede mitigar ciertas cuestiones que están por fuera del control de TrueLayer.
- TrueLayer implementa automáticamente un mecanismo de re-intento para llamadas Asíncronas, por lo que evita la necesidad de crear una lógica propia de error y reintento.
- La API de datos permite solicitudes asíncronas en todos los endpoints.
Tenga en cuenta que el endpoint /token no puede ser solicitado de manera asíncrona.
Realizar una solicitud Async
- Incluye el parámetro
async=truey unaresults_urique va a contener los resultados de tu solicitud una vez que estén disponibles. - Luego de realizar la llamada a la API de manera asíncrona, se puede sondear el
results_uriy esperar a que finalice la solicitud.
Para evitar el sondeo, puede incluir un paramétro de
webhook_uri para recibir notificaciones de tiempo real via HTTP POST (Webhook) cuando la solicitud ha sido completada.Tenga en cuenta que incluso si se incluye una
webhook_uri los resultados no serán parte de la carga del HTTP POST, sino que deben solicitarse en la results_uri.Cuando los resultados están listos, se podrán solicitar en la
results-uri. La solicitud va a incluir uno de los siguientes mensajes de status:|
STATUS
|
DESCRIPCIÓN
|
|
En espera (Queued)
|
La solicitud está esperando para ejectuarse
|
|
En funcionamiento (Running)
|
La solicitud está ejecutándose en el momento
|
|
Exitosa (Succeeded)
|
La solicitud ha entregado resultados con éxito
|
|
Fallada (Failed)
|
La solicitud ha fallado en entregar los resultados
|
Por lo tanto, una buena práctica sería solicitar el Status de la solicitud y sólo solicitar los resultados en el caso de que sea Exitosa (Succeeded).