Callback Notification

This document explains how our service sends secure notifications about your media processing tasks. We provide a verification mechanism to ensure these notifications are authentic and include detailed information about the processing results.

Notification Security Mechanism

To protect your security, we include an Authorization header with every notification request. This allows you to verify that notifications are legitimate and come from our service.

Authorization Header Format

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

Where:

• AccessKey is your account’s access key
• NotifyBody is the notification content
• SecretKey is your account’s secret key

Important: We randomly select one valid pair of AccessKey (AK) and AccessKey Secret (SK) from your account to generate the Authorization value. You should maintain a record of all your Access Keys and Access Key Secrets to authenticate callback notifications by matching the AccessKey used in the request.

Notification Content

When you configure a NotifyUrl, our service sends JSON-formatted notifications to this endpoint after processing your media. The notification content is URL-safe Base64-encoded and contains comprehensive information about your processing tasks.

Notification Requirements

Your callback URL must:

• Be accessible from the public internet
• Respond with an HTTP/1.1 200 OK status after receiving notifications

Notification Fields

Items Array Fields

Each item in the items array contains:

Detail Array Fields

Example Notification

{
    "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"
                }
            ]
        }
    ]
}