¿Qué es una Assembly Notification?
Una Assembly Notification de Transloadit es una solicitud POST opcional que se envía a una URL especificada cuando finaliza una Assembly. Su carga contiene el Assembly Status resultante.
Cómo funcionan las Assembly Notifications
Una notificación es una entrega de finalización de servidor a servidor que envía la representación final del trabajo a un endpoint de la aplicación. Desacopla el procesamiento multimedia de la duración de la conexión HTTP original y, por ello, resulta adecuada para flujos de trabajo persistentes en segundo plano. El receptor debería verificar la autenticidad, almacenar de forma persistente la identidad de la ejecución y confirmar la recepción solo después de procesarla de forma segura. La semántica de entrega también requiere una lógica de negocio que tolere duplicados en lugar de dar por hecho que habrá una sola solicitud.
Datos clave
- 1El cuerpo de la notificación contiene datos del estado de la Assembly, lo que permite al receptor correlacionar el evento, examinar cómo concluyó la Assembly y localizar los resultados sin mantener abierta la solicitud de subida.
- 2Una respuesta no exitosa del endpoint de callback puede dar lugar a otro intento de entrega, por lo que los efectos secundarios, como la publicación o la facturación, necesitan un control de idempotencia con una clave basada en la Assembly.
- 3Dado que el destino es una URL controlada por la aplicación, la disponibilidad del endpoint, la configuración de TLS, las comprobaciones de autenticación y la latencia de respuesta afectan a la fiabilidad de la entrega.
Cuándo son importantes las Assembly Notifications
Usa notificaciones en lugar de sondeo continuo cuando un sistema pueda recibir eventos asíncronos de finalización. Implementa la autenticación y haz que el receptor sea idempotente, porque las solicitudes falsificadas o repetidas no deben duplicar el trabajo.