Webhooks

Em vez de esperar uma Assembly terminar e sua requisição de API responder, você também pode configurar um webhook, também conhecido como Assembly Notification. O sistema envia uma requisição POST para uma URL de sua escolha contendo um relatório completo assim que uma Assembly termina.

Por que usar webhooks?

Ao optar por usar webhooks, você proporciona uma experiência mais fluida aos seus usuários finais, já que eles só precisam esperar os uploads de arquivos terminarem antes de fechar a janela do navegador. Sem uploads de arquivos, eles poderiam até fechar a janela do navegador imediatamente.

Configure e verifique webhooks

A documentação canônica da API de webhooks aborda os campos de configuração, os filtros de payload, a política de entrega, o formato de transmissão, a verificação de assinaturas e um exemplo em Node.js seguro contra ataques de temporização.

Testando webhooks localmente

Execute seu handler de webhook localmente e exponha-o com o Cloudflare Tunnel, o ngrok ou o pacote oficial @transloadit/notify-url-relay. O relay consulta periodicamente o Assembly Status público e encaminha as Notifications finais para o seu handler local notify_url.

$ TRANSLOADIT_SECRET=******** npx -y @transloadit/notify-url-relay \
    --notifyUrl "http://127.0.0.1:3020/transloadit_pingback" \
    --log-level info

Ao usar o relay, aponte o endpoint da Transloadit do seu app ou SDK para http://127.0.0.1:8888. Você também pode reenviar uma Notification pela página da Assembly correspondente.