Webhooks
Plutôt que d’attendre la fin d’une Assembly et la réponse à sa requête API, vous pouvez aussi configurer un webhook, également appelé Assembly Notification. Le système enverra à l’URL de votre choix une requête POST contenant un rapport complet dès qu’une Assembly se terminera.
Pourquoi utiliser des webhooks ?
En choisissant d’utiliser des webhooks, vous offrez une expérience plus fluide à vos utilisateurs finaux, car ils n’ont besoin d’attendre que la fin des téléversements de fichiers pour fermer la fenêtre du navigateur. Sans téléversement de fichiers, ils pourraient même la fermer immédiatement.
Configurer et vérifier les webhooks
La documentation de référence de l’API des webhooks présente les champs de configuration, les filtres de charge utile, la politique d’envoi, le format de transmission, la vérification des signatures et un exemple Node.js résistant aux attaques temporelles.
Tester les webhooks en local
Exécutez votre gestionnaire de webhooks en local, puis exposez-le via
Cloudflare Tunnel,
ngrok ou le relais officiel
@transloadit/notify-url-relay.
Le relais interroge périodiquement l’Assembly Status public et transmet les Notifications d’état final
à votre gestionnaire local notify_url.
$ TRANSLOADIT_SECRET=******** npx -y @transloadit/notify-url-relay \
--notifyUrl "http://127.0.0.1:3020/transloadit_pingback" \
--log-level info
Lorsque vous utilisez le relais, configurez le point de terminaison Transloadit de votre application
ou de votre SDK pour qu’il pointe vers http://127.0.0.1:8888. Vous pouvez aussi retenter l’envoi
d’une Notification depuis la page de l’Assembly correspondante.