callback_url说明

后台处理完文件的发布上传任务后，会通过POST方法，将上传的结果通知给callback_url。通知的数据格式为json，字段内容和含义如下表所示：

参数名	必选	类型	说明
sign	Y	string	签名值
signtime	Y	string	调用请求时的时间戳，单位为秒
vid	N	string	视频文件id
fileid	N	string	文件唯一id
ugcid	N	string	k歌平台的ugcid
shareid	N	string	k歌平台的分享id
md5	N	string	文件md5
status	Y	int	0 - 发布成功，1 - 文件下载失败， 2-文件检查失败 3-发布失败
desc	N	string	更新说明，如文件上传超时等描述

sign字段说明：
签名字段的计算过程为：
1、去除上述字段sign参数本身, 去除值为空的参数, 对所有参数按照参数名进行升序排序
2、对所有参数和参数值做字符串拼接
例如, 原始参数为:

{
    "k0" : "v0",
    "k1" : "v1"
    "k2" : ""
}

拼接后的字符串为
k0v0k1v1
3、上述字符串后端拼接 appkey, 例如 “k0v0k1v1appkey”
4、对拼接后的字符串做 32 位全小写 MD5 加密
服务端接收后, 验证流程如下:
1、获取 appid, 并查找对应的 appkey
2、获取 signtime 字段, 并且需要校验signtime与当前时间是否匹配, 允许误差时间为 20 秒
3、使用上述同样的算法计算出 sign 字段, 并进行验证

示例演示

请求如下
json参数如下：

{
    "song_id":"0025ARRr0HqJLg",
    "score":1234,
    "score_rank":2,
    "cover":"http://shp.qpic.cn/ttkg/0/506dc4d51122c0af047e47ef83f9fafc598174ad/0?t=1",
    "content":"我用全民K歌唱了一首歌111",
    "city":"北京",
    "file_name":"七里香.mp3",
    "file_size":2046790
}

返回结果

{
    "code":0,
    "msg":"请求成功",
    "data":"Succ"
}

callback_url说明

callback_url说明#

示例演示#

callback_url说明

示例演示