Assembly Status とは何ですか?

Transloadit の Assembly Status は、Assembly を JSON で表現したものです。Assembly の識別子、アップロード、結果、実行タイミング、および結果ファイルの場所を特定するために必要な情報が含まれます。

Assembly Status の仕組み

ステータス表現は、生成時点の処理ジョブを示す正規のスナップショットです。Transloadit は、Assembly 作成時のレスポンス、ステータス URL、通知ペイロードにこの共通形式を使用します。ライフサイクルの状態、時刻や所要時間、入力レコード、Step の出力、エラー、結果の保存先を、一つの機械可読ドキュメントにまとめています。途中のスナップショットは分岐の完了に伴って変化することがありますが、終端状態のスナップショットは結果を永続的に取り込む際に役立ちます。通常、バックエンドではこのドキュメントを独自のジョブモデルに正規化し、サポート時の診断に備えて識別子を保持します。

要点

  1. レスポンス内では、アップロードと生成結果が別々のコレクションになっています。これにより、クライアントは送信されたソースのレコードと Step が生成した派生ファイルを区別できます。
  2. 結果の各エントリーは Step 名ごとに整理されています。そのため、利用側では最初に返されたファイルを目的のアセットと見なさず、意図したワークフローの分岐に対応付ける必要があります。
  3. ポーリングを行うクライアントは、成功と失敗の終端状態を明示的に判別する必要があります。一部のメタデータや結果ファイルが存在しても、グラフ全体が成功した証拠にはなりません。

Assembly Status が重要になる場面

Assembly のステータス URL から取得し、完了の確認、結果 URL の収集、失敗した Step の診断に使用してください。同じドキュメントが Assembly 作成時にも返され、Assembly Notification でも配信されます。未完了のスナップショットを最終結果として扱わず、出力を利用する前に失敗の終端状態を処理してください。

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

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

Transloadit を無料で試す