暴風(fēng)云API接口文檔112

1、暴風(fēng)云API接口文檔1. 點播1.1.點播發(fā)布狀態(tài)查詢域名：協(xié)議：HTTP POST請求包POST /query HTTP/1.1Host: Content-Type: application/jsonContent-Length: 1234"token":"RzcS42tk1jLuoY4KdSH5XwcHKvYjb-SC9aGhakBH:EmZts8IUJhyGD1LSdFAOqF/g458=:eyJmaWxlbmFtZSI6IjkubXA0IiwiZmlsZWtleSI6IiIsInNlcnZpY2V0eXBlIjoxfQ="token內(nèi)容包含：fi

2、lename='abc.mp4' /文件名filekey='tom' /文件防重名加擾，可以為空servicetype=0 /1是點播服務(wù)，0是視頻云托管服務(wù)應(yīng)答包：HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 124Cache-Control: no-storeConnection: close"status":0,"fileid":"7A3526BEBD2A3063E2F4DCD852A34033","servic

3、etype":1,"filename":"9.mp4","showname":"9.mp4","filekey":"","filesize":202853188,"duration":3903226,"uploadtime":"2015-12-09 23:09:02","publishtime":"2015-12-10 00:10:57",&quo

4、t;ifpublic":1,"url":"servicetype=1&uid=5294383&fid=7A3526BEBD2A3063E2F4DCD852A34033"返回碼為:* 0：操作成功* 90：網(wǎng)絡(luò)錯誤* 99：系統(tǒng)錯誤* 101：文件已成功發(fā)布完成* 102：文件上傳中* 103：文件轉(zhuǎn)碼中* 104：用戶未購買對應(yīng)服務(wù)* 105：用戶空間不足* 106：用戶已被禁* 107：用戶余額不足* 131：用戶請求不支持* 132：非法用戶* 133：校驗錯誤* 134：用戶請求無法解析或缺少字段* 135：文件格式不支持

5、* 136：文件長度超長* 137：請求時間戳過期* 138：文件不存在* 200：發(fā)布中* 210：上傳成功* 211：轉(zhuǎn)碼成功* 212：審核通過* 214：CDN發(fā)布成功* 220：上傳失敗* 221：轉(zhuǎn)碼失敗* 222：審核不通過* 224：CDN發(fā)布失敗* 230：超時失敗1.2.視頻刪除接口域名：協(xié)議：HTTP POST請求包POST /delete HTTP/1.1Host: Content-Type: application/jsonContent-Length: 1234"token":"RzcS42tk1jLuoY4KdSH5XwcH

6、KvYjb-SC9aGhakBH:EmZts8IUJhyGD1LSdFAOqF/g458=:eyJmaWxlbmFtZSI6IjkubXA0IiwiZmlsZWtleSI6IiIsInNlcnZpY2V0eXBlIjoxfQ="token內(nèi)容包含：filename='abc.mp4' /文件名filekey='tom' /文件防重名加擾，可以為空deadline=1451491200 /過期時間callbackurl='' /刪除成功后回調(diào)的url，可為空servicetype = 1 /1是點播服務(wù)，0是視頻云托管服務(wù)，不能為空應(yīng)答包

7、：HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 23Cache-Control: no-storeConnection: close"status": errorcode返回碼為:同上1.3.視頻更改屬性接口域名：協(xié)議：HTTP POST請求包POST /changeproperty HTTP/1.1Host: Content-Type: application/jsonContent-Length: 1234"token":"RzcS42tk1jLuoY4K

8、dSH5XwcHKvYjb-SC9aGhakBH:EmZts8IUJhyGD1LSdFAOqF/g458=:eyJmaWxlbmFtZSI6IjkubXA0IiwiZmlsZWtleSI6IiIsInNlcnZpY2V0eXBlIjoxfQ="token內(nèi)容包含：filename='abc.mp4' /文件名filekey='test' /文件防重名加擾，可以為空filetype=1 /希望更改成的文件類型，0表示私有，1表示公開servicetype = 1 /1是點播服務(wù)，0是視頻云托管服務(wù)應(yīng)答包：HTTP/1.1 200 OKContent-Ty

9、pe: application/jsonContent-Length: 23Cache-Control: no-storeConnection: close"status": errorcode返回碼為:同上1.4.點播回調(diào)接口l 上傳回調(diào)POST /callback HTTP/1.1Host: Content-Length: 197Content-Type: application/jsonAccept: */*“status”:0,”type”:”upload”,”filename”:”hello.mp4”,”filekey”:”yhc”,”filesize”:1024

10、00,”duration”:5400,”servicetype”:0,”ifpublic”:0,”url”:”xxxxxxxxxx”l 刪除回調(diào)POST /callback HTTP/1.1Host: Content-Length: 197Content-Type: application/jsonAccept: */*“status”:0,”type”:”delete”,”filename”:”hello.mp4”,”filekey”:”yhc”,”filesize”:102400,”duration”:5400,”servicetype”:0,”ifpublic”:0,”url”:”xxx

11、xxxxxxx”1.5.點播大圖獲取接口一個點播文件會有8張截圖，獲取方式如下所示。l 訪問域名l /15/11618581和用戶綁定，可以認(rèn)為是不動的，其中15是由11618581 MOD 256再轉(zhuǎn)換為16進(jìn)制得到的l /00表示云托管，1表示點播l /common目錄名，可以認(rèn)為是不動的l /9039D72FF3DF7191693287121FD8D598.cov文件id，每個文件都對應(yīng)一個idl .0取值0-7，分別對應(yīng)8個截圖l .jpg圖片擴(kuò)展名1.6.點播小圖獲取接口點播文件有一個截圖伴隨文件kfp文件，這個文件中包含視頻文件的全程截圖（每隔10s）。這個文件的作用主要是用于圖片

12、審核、播放器進(jìn)度條展示。kfp文件格式如下所示：整個文件由文件頭部和文件體組成。文件頭包括：picnum ，headsize ，videotime和 全部的PicMetaData 文件體包括：各個Pic圖片文件各部分說明：picnum：整個文件中包含圖片的個數(shù)Headsize：文件頭部的長度Videotime: 視頻時長，單位秒PicMetaData ：PicName圖片名PicPos圖片文件相對于文件頭的偏移PicTime圖片文件相對于的視頻起始位置的秒數(shù)PicSize圖片文件的大小單位字節(jié)Pic：圖片文件headsize = 4 + 4 + 4 +sizeof(PicMetaData) *

13、 picnumPicPos1 = headsizePicPos2 = PicPos1 + PicSize1PicPos3 = PicPos2 + PicSize2.PicPosn = PicPosn-1 + PicSizen-12. 直播2.1.創(chuàng)建頻道域名：協(xié)議：HTTP POSTHTTP頭部：POST /createchannel HTTP/1.1Host: Content-Type: application/jsonContent-Length: 1234HTTP 包體："token": "createtoken"說明：createtoken的內(nèi)容

14、包括：* ifpublic：0是私有頻道，1是公有頻道* channelname：頻道名字* callback：回調(diào)地址，可以為空，如果不指定該字段則不回調(diào)。該回調(diào)地址會被直播開始、直播結(jié)束、錄制結(jié)束等操作觸發(fā)* ifrecord：是否允許錄制，0表示不錄制，1表示錄制，取1時下面的參數(shù)有效* recordname：錄制文件名前綴，可以為空，如果不指定該字段則錄制文件以頻道名稱為前綴* sizelimit：錄制文件最大字節(jié)數(shù)，以B為單位，最小不低于10M，最大不超過2G，與timelimit二選一* timelimit：錄制文件最大時

15、長，以秒為單位，最小不低于3分鐘，最大不超過3小時，與sizelimit二選一* recordposition：錄制文件存儲位置，0表示云托管，1表示點播，可以為空，如果不指定該字段則默認(rèn)存儲到云托管* deadline=1451491200 /該token過期時間，Unix時間返回包HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 1234Cache-Control: no-store"status":0,"channelid":"EF57D8EBF286B7D

16、6E80050970F3B59FC", "gcid":"545ED44113C2557662DD3E2321FF40D2F0579C58", "url":"servicetype=2&uid=4995606&fid=545ED44113C2557662DD3E2321FF40D2F0579C58"status為0表示創(chuàng)建直播頻道成功,并帶有channelid(頻道ID)和gcid(使用ID)。頻道ID指的是頻道上傳ID，用戶利用頻道上傳ID，可使用軟件將視頻直播流上傳到云平臺中。頻道ID是

17、用戶私有信息，用戶應(yīng)保證不讓第三方知道，如果頻道ID泄露，用戶可以在管理頻道頁面修改頻道ID（修改頻道ID將不會影響視頻播放）。"status":returncode返回碼為:*0表示操作成功* 99表示系統(tǒng)錯誤* 100表示請求的方法不支持* 101表示token無效* 102表示創(chuàng)建直播頻道失敗，參數(shù)值有錯誤* 103表示json數(shù)據(jù)格式錯誤* 104表示頻道個數(shù)超上限* 105表示非法用戶2.2.刪除頻道域名：協(xié)議：HTTP POSTHTTP頭部：POST /deletechannel HTTP/1

18、.1Host: Content-Type: application/jsonContent-Length: 1234HTTP 包體："token": "deletetoken"說明：deletetoken的內(nèi)容包括：* channelid = "EF57D8EBF286B7D6E80050970F3B59FC " /頻道id，創(chuàng)建頻道成功時，從返回http包體中獲得* deadline=1451491200 /該token過期時間，Unix時間返回包HTTP/1.1 200 OKContent-Type: appl

19、ication/jsonContent-Length: 1234Cache-Control: no-store"status":returncode返回碼為:* 0表示操作成功* 99表示系統(tǒng)錯誤* 100表示請求的方法不支持* 101表示token無效* 102表示刪除直播頻道失敗，參數(shù)值有錯誤* 103表示json數(shù)據(jù)格式錯誤* 104表示頻道個數(shù)超上限* 105表示非法用戶2.3.修改頻道域名：協(xié)議：HTTP POSTHTTP頭部：POST /modifychannel HTTP/1.1Host:

20、Content-Type: application/jsonContent-Length: 1234HTTP 包體："token": "modifytoken"說明：modifytoken的內(nèi)容包括：* ifpublic：0是私有頻道，1是公有頻道* channelname：頻道名字* callback：回調(diào)地址，可以為空，如果不指定該字段則不回調(diào)。該回調(diào)地址會被直播開始、直播結(jié)束、錄制結(jié)束等操作觸發(fā)* ifrecord：是否允許錄制，0表示不錄制，1表示錄制，取1時下面的參數(shù)有效* recordname：錄制文件

21、名前綴，可以為空，如果不指定該字段則錄制文件以頻道名稱為前綴* sizelimit：錄制文件最大字節(jié)數(shù)，以B為單位，最小不低于10M，最大不超過2G，與timelimit二選一* timelimit：錄制文件最大時長，以秒為單位，最小不低于3分鐘，最大不超過3小時，與sizelimit二選一* recordposition：錄制文件存儲位置，0表示云托管，1表示點播，可以為空，如果不指定該字段則默認(rèn)存儲到云托管* deadline=1451491200 /該token過期時間，Unix時間返回包HTTP/1.1 200 OKContent-Type: applic

22、ation/jsonContent-Length: 1234Cache-Control: no-store"status":returncode返回碼為:* 0表示操作成功* 99表示系統(tǒng)錯誤* 100表示請求的方法不支持* 101表示token無效* 102表示修改直播頻道失敗，參數(shù)值有錯誤* 103表示json數(shù)據(jù)格式錯誤* 104表示頻道個數(shù)超上限* 105表示非法用戶2.4.錄制開始域名：協(xié)議：HTTP POST請求包:POST /startrecord HTTP/1.1Host: Co

23、ntent-Type: application/jsonContent-Length: 1234"channelid":"01234567890123456789012345678901","callback":"","filename":"xxxlive",”recordname”:”test”,"sizelimit":1232141,”recordposition”:0或"channelid":"0123456789012

24、3456789012345678901","callback":"","filename":"xxxlive",”recordname”:”test”,"timelimit":300,”recordposition”:0channelid：直播頻道上傳idcallback：回調(diào)地址recordname：錄制文件名前綴sizelimit：錄制文件最大字節(jié)數(shù)，以B為單位，最大不能超過2Gtimelimit：錄制文件最大時長，以秒為單位，最大不能超過2小時recordposition：錄制文

25、件存儲位置，0表示云托管，1表示點播返回包HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 1234Cache-Control: no-store"status":0status值定義：0：操作成功99：系統(tǒng)錯誤300：磁盤空間滿301：頻道不存在302：不允許錄制303：處理超時2.5.結(jié)束錄制域名：協(xié)議：HTTP POST請求包:POST /stoprecord HTTP/1.1Host: Content-Type: application/jsonContent-Length: 1234"

26、;channelid":"01234567890123456789012345678901"channelid：直播頻道上傳id應(yīng)答包：HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 1234Cache-Control: no-store"status":0status值定義：0：操作成功99：系統(tǒng)錯誤2.6.獲取錄制列表域名：協(xié)議：HTTP POST或者GETPOST請求包:POST /getrecordlist HTTP/1.1Host: Content-Type:

27、application/jsonContent-Length: 1234"channelid":"72BC7FD637503A68985186CF464C47DC"channelid：直播頻道上傳idGET請求包:GET /getrecordlist?channelid=72BC7FD637503A68985186CF464C47DC HTTP/1.1Host: Content-Type: application/json應(yīng)答包：HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 12

28、34Cache-Control: no-store "status":0,"channelid":"CD9EE463EF5324C36F20CD8748F8E0F8","recordlist": "filename":"record_test_20160106124240_8561.mp4","duration":186130,"url":"servicetype=0&uid=5263465&fid=3238E

29、E7CE532AE117DF4FC41EFC39D5C","servicetype":0,"updatetime":"2016-01-06 12:45:54" ,"uploadstatus":0,"pictureurl":"http:/69/5263465/0/common/record_test_20160106124240_8561.jpg","filename":"record_test_20160106124547_7

30、752.mp4","duration":187488,"url":"servicetype=0&uid=5263465&fid=067AF4DFC6B6322C2D4894E2B18BC1D8","servicetype":0,"updatetime":"2016-01-06 12:45:54" ,"uploadstatus":0,"pictureurl":"http:/69/5263465

31、/0/common/record_test_20160106124547_7752.jpg"channelid：直播頻道上傳idrecordlist：直播錄制文件列表filename：錄制文件名稱duration：錄制文件播放時長，以毫秒為單位ifpublic：視頻屬性，0表示私有，1表示公有url：文件移動端代碼servicetype: 業(yè)務(wù)類型，0表示云存儲，1表示點播uploadstatus: 上傳狀態(tài)，0發(fā)布中，1發(fā)布成功，2發(fā)布失敗pictureurl：錄制文件截圖下載地址servicetype：業(yè)務(wù)類型，0表示云存儲，1表示點播status值定義：0：操作成功-1：沒有錄

32、制文件2.7.刪除錄制文件域名：協(xié)議：HTTP POST請求包:POST /delrecordfile HTTP/1.1Host: Content-Type: application/jsonContent-Length: 1234"channelid":"01234567890123456789012345678901",”filename”:”test.mp4”channelid：直播頻道上傳idfilename：錄制文件名，可以為空，如果filename為空則刪除頻道對應(yīng)所有的錄制文件應(yīng)答包：HTTP/1.1 200 OKContent-Type:

33、 application/jsonContent-Length: 1234Cache-Control: no-store“status”:0status值定義：0：操作成功-1：操作失敗2.8.獲取直播截圖一個直播頻道對應(yīng)2個id，一個是上傳id（32B），一個是使用id（40B），直播截圖的命名方式為：使用id-用戶id-時間戳.jpg，截圖大約30秒生成一個，每個截圖的名字都不一樣。舉例說明假設(shè)一個直播頻道：上傳id為：C346096876246F6BAA7265B1F8455F99使用id為：6E3F673D61A4558CC318BCE9F63F0EBD9D53EA14截圖：6E3F6

34、73D61A4558CC318BCE9F63F0EBD9D53EA14-4985300-1438166631.jpg域名：協(xié)議：HTTP GET請求包GET /queryliveimage?gcid=223939BCF66055A327BB1845F6703D6C1163AA09 HTTP/1.1Host: Content-Type: application/json應(yīng)答包：HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 1234Cache-Control: no-store"status":0,&q

35、uot;url":"http:/07/11886343/2/livepic/223939BCF66055A327BB1845F6703D6C1163AA09-11886343-1438655563.jpg" status值定義：0：表示查詢成功，其中url為截圖下載地址。-1：表示查詢失敗示例：2.9.直播在線人數(shù)查詢域名：協(xié)議：HTTP GET請求包GET /channelusercount?gcid=223939BCF66055A327BB1845F6703D6C1163AA09 HTTP/1.1Host: Content-Type: application/

36、json應(yīng)答包：HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 1234Cache-Control: no-store"usercount":0示例：2.10.直播頻道狀態(tài)查詢接口域名：協(xié)議：HTTP GET請求包GET /channelstate?gcid=223939BCF66055A327BB1845F6703D6C1163AA09 HTTP/1.1Host: Content-Type: application/json應(yīng)答包：HTTP/1.1 200 OKContent-Type: appli

37、cation/jsonContent-Length: 1234Cache-Control: no-store"status":0,"gcid":"223939BCF66055A327BB1845F6703D6C1163AA09"status值定義：0：正在直播100：直播沒開始101：直播已經(jīng)結(jié)束102：直播請求錯誤2.11.直播回調(diào)l 直播開始回調(diào)POST /live/recordcallback?room_id=5465 HTTP/1.1Host: Content-Length: 197Content-Type: applicat

38、ion/jsonAccept: */*"type":"startlive","gcid":"8CD4967029E04C68B406BA4129BDD06120894919","channelid":"C14EE21DF122F698D41A9762A08C767F","url":"servicetype=2&uid=11618581&fid=8CD4967029E04C68B406BA4129BDD06120894919&quo

39、t;l 直播結(jié)束回調(diào)POST /live/recordcallback?room_id=5465 HTTP/1.1Host: Content-Length: 197Content-Type: application/jsonAccept: */*"type":"stoplive","gcid":"8CD4967029E04C68B406BA4129BDD06120894919","channelid":"C14EE21DF122F698D41A9762A08C767F",&q

40、uot;url":"servicetype=2&uid=11618581&fid=8CD4967029E04C68B406BA4129BDD06120894919"l 錄制結(jié)束回調(diào)POST /recordcallback HTTP/1.1Host: Content-Length: 197Content-Type: application/jsonAccept: */*“status”:0,"type":"liverecord",”channelid”:”0123456789012345678901234567

41、8901”,”recordlist”:”filename”:”test_1”,”duration”:13678,”ifpublic”:1,”url”:”servicetype=1&uid=5294383&fid=C346096876246F6BAA7265B1F8455F99”，“pictureurl”:”http:/71/5304689/1/common/test_1.jpg”,"servicetype":1,”filename”:”test_2”,”duration”:16788,”ifpublic”:1,”url”:”servicetype=1&

42、;uid=5294383&fid=881EA544D58C2D4131FBC2FCE9962D6B”“pictureurl”:”http:/71/5304689/1/common/test_2.jpg”,"servicetype":1channelid：直播頻道上傳idrecordlist：直播錄制文件列表filename：錄制文件名稱duration：錄制文件播放時長，以毫秒為單位ifpublic：視頻屬性，0表示私有，1表示公有url：文件移動端代碼pictureurl：錄制文件截圖下載地址servicetype：業(yè)務(wù)類型，0表示云存儲，1表示點播2.12.統(tǒng)計

43、狀態(tài)查詢接口2.12.1按月查詢點播文件統(tǒng)計信息域名：協(xié)議：HTTP GET請求包GET / filestatmonth?fileid=EED3549D2FB7DC8E2181967869D60CB7&time=20160101&uid=5263465&servicetype=1 HTTP/1.1Host: Content-Type: application/json應(yīng)答包：HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 1234Cache-Control: no-store"statu

44、s":0,"uid":5263465,"fileid":"EED3549D2FB7DC8E2181967869D60CB7","time":"20160101","vv":108,"downloads":60012000,"totaltime":1256status：0成功，-1失敗uid：用戶idfileid：需要查詢的文件idtime：需要查詢時間servicetype：需要查詢的業(yè)務(wù)id，0云托管，1點播vv：文件本月內(nèi)

45、的總訪問量downloads：文件本月內(nèi)的總下載量totaltime：文件本月內(nèi)的總播放時間2.12.2按天查詢點播文件統(tǒng)計信息域名：協(xié)議：HTTP GET請求包GET / filestatday?fileid=EED3549D2FB7DC8E2181967869D60CB7&time=20160101&uid=5263465&servicetype=1 HTTP/1.1Host: Content-Type: application/json應(yīng)答包：HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 1234Cache-Control: no-store"status":0,"uid":5263465,"fi