Assembly Notification とは何ですか?

Transloadit の Assembly Notification は、Assembly の完了後に指定された URL に送信される任意の POST リクエストです。そのペイロードには、結果として得られた Assembly Status が含まれます。

Assembly Notification の仕組み

通知は、ジョブの最終的な表現をアプリケーションのエンドポイントにプッシュする、サーバー間の完了通知です。メディア処理を元の HTTP 接続の存続期間から切り離せるため、永続性のあるバックグラウンドワークフローに適しています。受信側では真正性を検証し、実行の識別情報を永続化して、安全に処理した後にのみ受信確認を返す必要があります。また、配信の仕組み上、リクエストが一回だけ届くと想定せず、重複しても安全なビジネスロジックが必要です。

要点

  1. 通知の本文には Assembly のステータスデータが含まれます。受信側は、アップロードリクエストを開いたままにせずに、イベントを対応付け、最終結果を確認し、処理結果の場所を特定できます。
  2. コールバックエンドポイントが成功以外の応答を返すと、配信が再試行される場合があります。そのため、公開や課金などの副作用を伴う処理には、Assembly をキーとする冪等性の保護が必要です。
  3. 送信先はアプリケーションが管理する URL のため、エンドポイントの可用性、TLS 設定、認証処理、応答遅延のすべてが確実な受け渡しに影響します。

Assembly Notification が重要になる場面

非同期の完了イベントを受信できるシステムでは、継続的なポーリングの代わりに通知を使用してください。偽造されたリクエストや繰り返されたリクエストによって処理が重複しないよう、認証を行い、受信側の処理を冪等にしてください。

メディアの知識を実用的なパイプラインに

単一の宣言的 API で、アップロード、処理、AI、ストレージ、配信を連携できます。エンコードスタックの管理、スケーリング、形式の変化への対応はお任せください。

Transloadit を無料で試す