プラットフォーム Callback

Kollus VOD は、アップロード、トランスコーディング、コンテンツ管理などの主要なワークフローが完了したとき、お客様が指定した URL に通知(Callback)を送信します。 これにより、外部システムとのリアルタイム同期およびワークフローの自動化を実現できます。

プラットフォーム Callback の種類

• Upload Callback
• Transcoding Callback
• Contents Update Callback
• チャンネルにコンテンツ登録時の Callback
• チャンネルからコンテンツ削除時の Callback

Callback 設定方法

Callback URL は Kollus VOD コンソールで設定できます。

• 参考文書: Callback 連携 - プラットフォーム Callback

Callback の流れ

通信規格

転送方式

• Method: POST
• Content-Type: application/x-www-form-urlencoded
• 送信タイミング: イベント発生時に即時送信

応答条件

お客様のサーバーはリクエストを受信した後、以下の条件に従って応答する必要があります。

• 成功応答: HTTP Status Code 200 を返す（レスポンスボディは無視されます）
• 失敗判定: 200 以外のステータスコードの返却または Timeout の発生（再試行キューに登録されます）

Timeout 制限

区分	制限時間	説明
Connect Timeout	2 秒	サーバー接続試行の制限時間
Response Timeout	3 秒	リクエスト送信後の応答待機制限時間

再試行

再試行ポリシー

一時的なネットワーク障害やお客様のサーバーの遅延により送信が失敗した場合、システムは自動的に再試行を行います。

• 再試行間隔: 5 分間隔
• 最大回数: 3 回（初回送信を含む合計 4 回試行）
• ログ確認: すべての送信および再試行結果はログに記録されます。

⚠️ Callback 重複受信の防止

ネットワーク遅延により、お客様のサーバーが正常に処理して応答を送信したにもかかわらず、Kollus システムで Timeout と認識して Callback を再送信する場合があります。

• 推奨事項: お客様のシステムは、同一イベントを重複受信しても、データ整合性に問題が生じないよう重複処理防止ロジックを必ず実装してください。

リクエストパラメーター

各イベントごとに送信されるパラメーターの仕様です。

参考文書

キー (Key) 情報については、認証と主要キードキュメントを参照してください。

アップロード完了 Callback

パラメーター	タイプ	説明
content_provider_key	string	サービスアカウントキー
full_filename	string	フォルダーパスを含む原本ファイル名
filename	string	原本ファイル名
upload_file_key	string	アップロードファイルキー

トランスコーディング完了 Callback

パラメーター	タイプ	説明
content_provider_key	string	サービスアカウントキー
filename	string	原本ファイル名
upload_file_key	string	アップロードファイルキー
transcoding_result	string	トランスコーディング結果 success: 成功 fail: 失敗

コンテンツ更新完了 Callback

パラメーター	タイプ	説明
content_provider_key	string	サービスアカウントキー
full_filename	string	フォルダーパスを含む原本ファイル名
filename	string	原本ファイル名
upload_file_key	string	アップロードファイルキー
update_type	string	更新タイプ(content_*)

チャンネルへのコンテンツ登録完了 Callback

パラメーター	タイプ	説明
content_provider_key	string	サービスアカウントキー
full_filename	string	フォルダーパスを含む原本ファイル名
filename	string	原本ファイル名
upload_file_key	string	アップロードファイルキー
media_content_key	string	メディアコンテンツキー
channel_key	string	コンテンツが登録されたチャンネルの識別キー
channel_name	string	コンテンツが登録されたチャンネル名
profile_key	string	適用されたエンコーディングプロファイルキーのリスト（| 区切り文字を使用）
update_type	string	更新タイプ(channel_join)

チャンネルからのコンテンツ削除完了 Callback

パラメーター	タイプ	説明
content_provider_key	string	サービスアカウントキー
full_filename	string	フォルダーパスを含む原本ファイル名
filename	string	原本ファイル名
upload_file_key	string	アップロードファイルキー
media_content_key	string	メディアコンテンツキー
channel_key	string	コンテンツが登録されたチャンネルの識別キー
channel_name	string	コンテンツが登録されたチャンネル名
update_type	string	更新タイプ(channel_leave)