CDN页面刷新接口定义[高升]

Posted 2020-10-08

一 、 任务 分发 工作流程
步骤 1. 合作方按照高升定义的 json 数据格式向高升分发接口 post 任务，高升分发接口
会根据接收情况即时反馈接收成功还是失败的结果。
二 、 高升 分发 接口 定义 和 返回值
1. post 方式 （建议 使用第二种方式） ） ：
a. 通过 http 参数方式 post，例如：
http:// api.gosun.com/portal/task/refresh?context=这里是 json 数据
b. 通过 http 的 body 来 post，body 的内容就是 json 数据。
2. json 的 数据格式定义：
{
"userid": "2",
"digest": "md5(userid+key+firsturl)",
"urls": [
{
"url": "http://vkpws.video.qq.com/flv/49/183/t0014nb11jb.p603.1.mp4",
"itemid": "12345678",
"action": "refresh",
},
{
"url": "http://vkpws.video.qq.com/flv/49/183/ ",
"itemid": "12345679",
"action": "path_refresh",
}
]
}
字段说明：
userid：必填。高升分配给合作方的用户 id
digest：必填。接口的校验码，若校验失败，不能提交数据。key 是高升分配给合作方
的 密 钥 ， firsturl 为 第 一 条 任 务 。 假 设 userid=2 ， key=gosun ， firsturl=
http://vkpws.video.qq.com/flv/49/183/t0014nb11jb.p603.1.mp4，
那 么 digest 为 md5(2gosunhttp://vkpws.video.qq.com/flv/49/183/t0014nb11jb.p603.1.mp4)=
023a3d180e26409e3639be2a710c2700
urls：必填。url 数组，一次可以分发多个任务。（最多不超过 100 条）
url：必填。要分发的文件的发布地址（发布地址即 url 做分发任务时候不能有问号参数，
不能带端口号，中文 url 提交原始 url，非转义的 url）。
itemid：必填。能代表文件的键值，可以为字符串。（长度不超过 100 字符）
action：必填。分发动作，取值范围： refresh（刷新）、path_refresh（目录刷新）。
3. 接口 返回值 ：
{
"msg":"success",
"result": {
"post 过来的 itemid": "0",
"post 过来的 itemid": "1"
}
}
字段说明：
msg：返回值描述，当一些错误信息可以在此输出。
result：结果集，key 是之前 post 过来的 itemid，value 是接收结果（0 是成功，大于 0
是失败）
value 代码说明：
0：任务成功
1：任务解释异常或入库异常
2：域名未在 cdn 系统注册
3：域名未开启分发或是域名获取失败
4：action 不在指定范围
5：此任务正在进行中
6：入库异常或是数据格式有错