Webhooks

En lugar de esperar a que finalice una Assembly y responda su solicitud a la API, también puedes configurar un webhook, también conocido como Assembly Notification. El sistema enviará una solicitud POST a una URL que elijas con un informe completo una vez que finalice una Assembly.

¿Por qué usar webhooks?

Al optar por usar webhooks, permites que tus usuarios finales disfruten de una experiencia más fluida, ya que solo necesitan esperar a que finalicen las subidas de archivos antes de cerrar la ventana del navegador. Si no hay subidas de archivos, incluso podrían cerrar la ventana del navegador de inmediato.

Configura y verifica webhooks

La documentación canónica de la API de Webhooks explica los campos de configuración, los filtros de carga útil, la política de entrega, el formato de transmisión, la verificación de firmas y muestra un ejemplo de Node.js con comparación de tiempo constante.

Probar webhooks localmente

Ejecuta tu controlador de webhooks en local y exponlo mediante Cloudflare Tunnel, ngrok o la herramienta oficial @transloadit/notify-url-relay. El relay consulta el Assembly Status público y reenvía las Notifications finales a tu controlador local de notify_url.

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

Cuando uses el relay, configura el endpoint de Transloadit de tu aplicación o SDK como http://127.0.0.1:8888. También puedes reenviar una Notification desde la página de la Assembly.