一 、 任務 分發 工作流程
步驟 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:入庫異常或是資料格式有錯