天天看點

cdn重新整理api_CDN頁面重新整理接口定義[高升]

一 、 任務 分發 工作流程

步驟 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:入庫異常或是資料格式有錯