Webhooks

Statt auf den Abschluss einer Assembly und die Antwort auf deren API-Anfrage zu warten, können Sie auch einen Webhook konfigurieren, der ebenfalls als Assembly Notification bezeichnet wird. Sobald eine Assembly beendet ist, sendet das System einen vollständigen Bericht per POST-Anfrage an eine URL Ihrer Wahl.

Warum Webhooks verwenden?

Mit Webhooks bieten Sie Ihren Endnutzerinnen und Endnutzern ein reibungsloseres Erlebnis, da sie nur warten müssen, bis die Datei-Uploads abgeschlossen sind, bevor sie das Browserfenster schließen. Ohne Datei-Uploads könnten sie das Browserfenster sogar sofort schließen.

Webhooks konfigurieren und verifizieren

Die kanonische Webhooks-API-Dokumentation behandelt Konfigurationsfelder, Payload-Filter, Zustellrichtlinien, das Wire-Format, die Signaturprüfung und ein zeitkonstantes Node.js-Beispiel.

Webhooks lokal testen

Starten Sie Ihren Webhook-Handler lokal und machen Sie ihn anschließend über Cloudflare Tunnel, ngrok oder das von uns bereitgestellte @transloadit/notify-url-relay erreichbar. Das Relay fragt den öffentlichen Assembly Status ab und leitet abschließende Notifications an Ihren lokalen Handler für notify_url weiter.

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

Wenn Sie das Relay verwenden, richten Sie den Transloadit-Endpunkt Ihrer App oder Ihres SDKs auf http://127.0.0.1:8888. Sie können eine Notification auch auf der zugehörigen Assembly-Seite erneut senden.