Webhook
Assembly の完了と API リクエストへの応答を待つ代わりに、Assembly Notification とも呼ばれる Webhook を設定できます。Assembly が終了すると、指定した URL に詳細なレポートを含む POST リクエストが送信されます。
Webhook を使う理由は?
Webhook を利用すると、エンドユーザーはファイルアップロードの完了を待つだけでブラウザーウィンドウを閉じられるため、よりスムーズな操作体験を提供できます。ファイルアップロードがなければ、すぐにブラウザーウィンドウを閉じることもできます。
Webhook の設定と検証
正式な Webhook API ドキュメントでは、設定フィールド、ペイロードフィルター、配信ポリシー、通信形式、署名検証に加え、タイミング攻撃に対して安全な Node.js の実装例を紹介しています。
ローカルでの Webhook のテスト
Webhook ハンドラーをローカルで実行し、Cloudflare Tunnel、ngrok、または公式の
@transloadit/notify-url-relayを使って公開します。このリレーは公開された Assembly Status をポーリングし、終了状態の Notifications をローカルの notify_url ハンドラーに転送します。
$ TRANSLOADIT_SECRET=******** npx -y @transloadit/notify-url-relay \
--notifyUrl "http://127.0.0.1:3020/transloadit_pingback" \
--log-level info
リレーを使用する場合は、アプリまたは SDK の Transloadit エンドポイントを
http://127.0.0.1:8888 に設定してください。Assembly ページから Notification の送信を再試行することもできます。