Callback Notification

本ドキュメントでは、メディア処理タスクに関するセキュアな通知送信方法と、通知の真正性を保証する検証メカニズムについて説明します。処理結果の詳細情報を含む通知を安全に配信します。

セキュリティ検証メカニズム

通知リクエストにはAuthorizationヘッダーを付与し、通知の正当性を検証可能にします。

Authorizationヘッダー形式

<AccessKey>:URLSAFE_BASE64(HMAC_SHA1(NotifyUrlWithOutQuery + "\n" + NotifyBody, SecretKey))

パラメータ説明：

• AccessKey：アカウントアクセスキー
• NotifyBody：通知内容本体
• SecretKey：アカウントシークレットキー

重要：通知生成時にアカウント内の有効なAK/SKペアからランダムに選択されます。すべてのAccessKeyとAccessKey Secretを適切に管理し、リクエスト内のAccessKeyを照合して検証してください。

通知内容仕様

NotifyUrl設定後、メディア処理完了時にJSON形式の通知を送信します。通知内容はURLセーフBase64エンコードされ、処理タスクの詳細情報を含みます。

コールバック要件

コールバックURLは以下を満たす必要があります：

• パブリックインターネットからアクセス可能
• 通知受信後HTTP/1.1 200 OKステータスを返却

通知フィールド

items配列フィールド

detail配列フィールド

通知サンプル

{
    "id": "2c90802745ee87870145ef1430f90006",
    "code": 3,
    "desc": "operate [\"avthumb/flv\"] is finish",
    "separate": 0,
    "inputkey": "aaa.flv",
    "inputbucket": "chenqltesttwo",
    "inputfsize": 20000,
    "items": [
        {
            "cmd": "avthumb/flv",
            "code": "3",
            "costTime": 0,
            "desc": "finish",
            "error": null,
            "fsize": 20000,
            "hash": "FlWvHsc-CK6miygKCcLjCaQ5csNO",
            "key": "chenqltesttwo:aaa.flv",
            "url": "http://chenqltesttwo.com/aaa.flv",
            "duration": 198.083,
            "bit_rate": "1288025",
            "resolution": "1280X720",
            "detail": [
                {
                    "fsize": 20000,
                    "tssize": 1024,
                    "hash": "FlWvHsc-CK6miygKCcLjCaQ5csNO",
                    "key": "chenqltesttwo:aaa.flv",
                    "url": "http://chenqltesttwo.com/aaa.flv",
                    "duration": 198.083,
                    "bit_rate": "1288025",
                    "resolution": "1280X720"
                }
            ]
        }
    ]
}