O que é uma Assembly Notification?
Uma Assembly Notification da Transloadit é uma requisição POST opcional enviada a uma URL especificada após a conclusão de uma Assembly. Seu payload contém o Assembly Status resultante.
Como funcionam as Assembly Notifications
Uma notificação é uma entrega de conclusão entre servidores que envia o documento de status final da Assembly a um endpoint da aplicação. Ela desvincula o processamento de mídia da duração da conexão HTTP de origem e, por isso, é adequada para fluxos de trabalho duráveis em segundo plano. O receptor deve verificar a autenticidade, persistir a identidade da execução e confirmar o recebimento somente após o tratamento seguro. A semântica de entrega também exige uma lógica de negócio que lide com duplicatas de forma segura, em vez de presumir uma única requisição.
Informações essenciais
- 1O corpo da notificação contém dados de estado da Assembly, permitindo que o receptor correlacione o evento, examine o desfecho final e localize os resultados sem manter a requisição de upload aberta.
- 2Uma resposta que não indique sucesso, enviada pelo endpoint de callback, pode levar a outra tentativa de entrega. Por isso, efeitos colaterais como publicação ou cobrança precisam de uma proteção de idempotência que use a Assembly como chave.
- 3Como o destino é uma URL controlada pela aplicação, a disponibilidade do endpoint, a configuração de TLS, as verificações de autenticação e a latência da resposta afetam a confiabilidade da entrega.
Quando as Assembly Notifications são importantes
Use notificações em vez de consultas periódicas contínuas quando um sistema puder receber eventos assíncronos de conclusão. Autentique as requisições e torne o receptor idempotente, pois requisições forjadas ou repetidas não devem duplicar o trabalho.