文档管理

• 回调事件
• 回调签名
• 回调格式
• callback/set-event 设置回调事件
• callback/event-info 查看当前回调信息
• 活动开始结束回调通知
• JSSDK 上传视频完成创建回放通知
• JSSDK 上传视频完成转码后通知
• 回放生成成功后通知

回调接口示例代码：

callback.php

<?php
    //PHP版本代码
    $privateKey = 'abcdefg';//接口设置的private_key参数（回调接口验证私钥）
    data = $_POST;
    $sign = $data['signature'];
    unset($data['signature']);
    $sign_new = makeSignature($data , $privateKey);//调用签名生成函数
    if($sign == $sign_new){
        echo 'succ';
    }else{
        echo 'fail';
    }
 
    //$privateKey为回调接口私钥
    //$data为回传的POST数据数组，剔除掉signature键值
    //签名生成函数
    function makeSignature(array $data, $privateKey){
        ksort($data);
        $str = null;
        $privateKey = md5($privateKey);
        foreach ($data as $k => $v){
            $str .= $k.'|'.$privateKey.'|'.$v;
        }
        return md5($str);
    }
?>

	User-Agent: vhall
	Content-Type: application/json
	Content-Length: content length

{
    record_id: 56345,  // 回放ID
    method_id: 3, // 回调事件ID
    status: "3", // 转码ID
    refer: "vhall", // 来源
    time: 1505095994, // 当前时间戳
    sign: "58d85e40c577596c49e0217e2297728, // 签名
}

回调域名在收到消息后需要返回 字符串 success 任何非success的数据返回会未返回均被认为是失败的回调

Vhall服务器器会在时候后尝试从新放松，当失败3次后 失败消息会记录到失败列表中，可通过失败回调接口查询

设置回调事件

URL http://e.vhall.com/api/vhallapi/v2/callback/set-event 

返回形如

{
    "code":200,
    "msg":"success",
    "data":{}
}

的json,data值的数据格式如下

错误码

查看当前回调信息

URL http://e.vhall.com/api/vhallapi/v2/callback/event-info 

返回形如

{
    "code": "200",
    "msg": "成功",
    "data": {
        "callback_url": "http://www.domain.com/api/callback",
        "callback_event": "2,3",
        "secret_key": "abcedfg"
    }
}

的json,data值的数据格式如下

错误码

{
    method_id: 1, // int 回调事件ID
    refer: "vhall", // string 来源
    time: 1505095994, // int 当前时间戳
    webinar_id: 123456,  // int 活动ID
    third_user_id : "123456", // string 第三方用户ID （无第三方账户，返回空字符串）
    type : 1, // int 活动状态 1 开始 3 结束
    signature: "7ffa066561d280d0d51f8fdaad29f4a4", // string 签名
}

{
    method_id: 2, // 回调事件ID
    refer: "vhall", // 来源
    time: 1505095994, // 当前时间戳
    record_id: 56345,  // 回放ID
    signature: "7ffa066561d280d0d51f8fdaad29f4a4", // 签名
}

{
    method_id: 3, // int 回调事件ID
    refer: "vhall", // string 来源
    time: 1505095994, // int 当前时间戳
    record_id: 56345,  // int 回放ID
    status: "3", // string 转码状态 1 成功 3 失败
    signature: "58d85e40c577596c49e0217e2297728, // string 签名
}

{
    method_id: 4, // int 回调事件ID
    refer: "vhall", // string 来源
    time: 1505095994, // int 当前时间戳
    record_id: 56345,  // int 回放ID
    webinar_id: 673246345,  // int 活动ID
    status: "3", // string 转码状态 1 成功 2 失败
    signature: "58d85e40c577596c49e0217e2297728, // string 签名
}