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

时间:2023-12-14 17:33:44

一 、 任务 分发 工作流程
步骤 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:入库异常或是数据格式有错