¿Qué es Async Mode?
Async Mode permite que un cliente continúe después de que finalice su solicitud o subida mientras Transloadit procesa la Assembly por separado. Cuando la Assembly especifica una notify_url, una Assembly Notification entrega después los resultados al back end del cliente.
Cómo funciona Async Mode
Async Mode cambia el ciclo de vida de la solicitud, no el grafo de procesamiento: el cliente deja de esperar una vez completado el envío, mientras la Assembly continúa en la infraestructura del servicio. Los datos finales llegan mediante la notificación enviada al notify_url configurado, en lugar de una respuesta interactiva que permanece abierta durante toda la tarea, lo que evita que se agoten los tiempos de espera del cliente y del proxy durante el procesamiento multimedia costoso. Las aplicaciones que no pueden recibir notificaciones pueden consultar periódicamente la URL de Assembly Status hasta que aparezca un estado final. La aplicación debe mantener un estado de correlación persistente y mostrar mediante su propia interfaz si la tarea está pendiente, se ha completado correctamente o ha fallado.
Datos clave
- 1La respuesta inicial confirma la entrega de la solicitud para su procesamiento, no la generación correcta de la salida multimedia, por lo que un sistema orientado al usuario necesita un estado independiente entre la aceptación del envío y la finalización definitiva.
- 2Las Assembly Notifications se envían solo cuando la Assembly especifica un
notify_url, y recibirlas requiere un endpoint de servidor accesible. Una pestaña del navegador o un proceso móvil no es un receptor fiable; los clientes sin un endpoint de servidor deberían consultar periódicamente la URL de Assembly Status para comprobar si el procesamiento ha finalizado. - 3Los reintentos y los eventos de aplicación que llegan fuera de orden son aspectos habituales de los sistemas distribuidos, por lo que el receptor debería usar la identidad de la Assembly como clave para las actualizaciones y rechazar las transiciones de estado obsoletas.
Cuándo es relevante Async Mode
Elige Async Mode cuando el procesamiento pueda durar más que una solicitud interactiva o no deba bloquear al cliente, y configura notify_url para que los resultados lleguen a tu backend. El endpoint receptor debe autenticar las notificaciones y gestionar de forma segura los reintentos o las entregas duplicadas; las integraciones sin un endpoint de servidor pueden consultar periódicamente Assembly Status como alternativa.