荔枝云平臺(tái)統(tǒng)一媒體資源管理v

1、荔枝云-PaaS 平臺(tái)統(tǒng)一管理規(guī)范(V1.2)江蘇省廣播電視總臺(tái)北京新奧特云視科技2015 年 7 月目錄第 1 章包規(guī)范8包81 . 1屬性說(shuō)明8屬性格式91 . 2 基本信息9屬性說(shuō)明9屬性格式10信息類型101 . 3屬性說(shuō)明10屬性格式11文件類型111 . 4屬性說(shuō)明11屬性格式131 . 5 音頻文件類型14屬性說(shuō)明14屬性格式151 . 6 圖片文件類型16屬性說(shuō)明16屬性格式171 . 7 圖形文件類型17屬性說(shuō)明17屬性格式181 . 8 文稿類型19屬性說(shuō)明19屬性格式201 . 9 其他文件類型20屬性說(shuō)明20屬性格式211 . 10 視音頻出入點(diǎn)類型22屬性說(shuō)明22屬性

2、格式221 . 11 TAG類型22屬性說(shuō)明22屬性格式231 . 12 擴(kuò)展屬性類型23屬性說(shuō)明23屬性格式23第 2 章 調(diào)用說(shuō)明242 . 1 概述242 . 2 請(qǐng)求結(jié)構(gòu)說(shuō)明24請(qǐng)求地址24公共參數(shù)25地址示例252 . 3 返回結(jié)果25第 3 章 接口認(rèn)證263 . 1 獲取令牌26功能描述26接口地址26請(qǐng)求參數(shù)26返回參數(shù)26請(qǐng)求示例26返回示例27服務(wù)狀態(tài)碼列表273 . 2第 4 章 媒資服務(wù)28注入284 . 1FTP 上傳28斷點(diǎn)續(xù)傳28上傳進(jìn)度4 . 2. 32功能描述32接口地址32參數(shù)說(shuō)明32返回參數(shù)33請(qǐng)求示例33返回示例334 . 3. 34功能描述34接口地址

3、34參數(shù)說(shuō)明34返回參數(shù)35請(qǐng)求示例35返回示例364 . 4. 37功能描述37接口地址37參數(shù)說(shuō)明37返回參數(shù)37請(qǐng)求示例37返回示例384 . 5 按條件. 40功能描述40接口地址40參數(shù)說(shuō)明40返回參數(shù)40請(qǐng)求示例41返回示例414 . 6 刪除. 43功能描述43接口地址43參數(shù)說(shuō)明43返回參數(shù)44請(qǐng)求示例44返回示例444 . 7 更新包信息45功能描述45接口地址45參數(shù)說(shuō)明45返回參數(shù)45請(qǐng)求示例45返回示例464 . 8 更新多文件信息新增47功能描述47接口地址47參數(shù)說(shuō)明47返回參數(shù)48請(qǐng)求示例48返回示例494 . 9 更新多文件信息刪除49功能描述49接口地址50參

4、數(shù)說(shuō)明50返回參數(shù)50請(qǐng)求示例50返回示例514 . 10. 51功能描述51接口地址51參數(shù)說(shuō)明52返回參數(shù)52請(qǐng)求示例52返回示例52取消4 . 11. 53功能描述53接口地址53參數(shù)說(shuō)明53返回參數(shù)53請(qǐng)求示例53返回示例54的用戶列表544 . 12功能描述54接口地址55參數(shù)說(shuō)明55返回參數(shù)55請(qǐng)求示例55返回示例564 . 13 媒資服務(wù)狀態(tài)碼列表56第1章包規(guī)范本文檔中的所涉及的接口的主要是提供對(duì)于的云端處理服務(wù)，為了更好的實(shí)現(xiàn)統(tǒng)一管理和調(diào)度，荔枝云平臺(tái)遵照全臺(tái)網(wǎng) 2.0 的要求對(duì)于格式進(jìn)行了統(tǒng)一的規(guī)范，本文檔中所涉及到云的服務(wù)都將遵從包規(guī)范的內(nèi)容來(lái)實(shí)現(xiàn)。請(qǐng)?jiān)谶M(jìn)行服務(wù)對(duì)接前，先

5、需要了解包的定義規(guī)范，以免影響您的工作進(jìn)行。1.1包屬性說(shuō)明包屬性含義包括對(duì)象、集合、屬性。一個(gè)包在進(jìn)行構(gòu)造時(shí)，必須根據(jù)“是否必填屬性”說(shuō)明進(jìn)行構(gòu)造；一個(gè)包必須指定加入一個(gè) baseInfo 屬性；其他屬性字段，根據(jù)具體業(yè)務(wù)參數(shù)進(jìn)行構(gòu)造即可。包構(gòu)造時(shí)，對(duì)應(yīng)的屬性需要根據(jù)屬性類型和屬性說(shuō)明進(jìn)行構(gòu)造。屬性含義類型說(shuō)明必填materialPackage對(duì)象無(wú)素材內(nèi)容信息是baseInfo對(duì)象baseInfoType包基本信息是copyrightInfo對(duì)象copyrightInfoType信息否contentFiles對(duì)象無(wú)多文件信息否Files集合FileType文件信息否audioFiles集合

6、audioFileType音頻文件信息否imageFiles集合imageFileType圖片文件信息否graphFiles集合graphFileType圖形文件信息否scriptFiles集合scriptFileType文稿對(duì)象信息否otherFiles集合otherFileType其他文件信息否tagItems集合tagItemTypeTag集合否extendAttributes集合extentionAttributeType擴(kuò)展屬性信息否屬性格式1.2 基本信息屬性說(shuō)明屬性含義類型說(shuō)明必填baseInfo對(duì)象無(wú)包基本信息是pkGUID屬性string包唯一標(biāo)識(shí)否title屬性string

7、標(biāo)題是origin屬性string來(lái)源否owner屬性string所有者是creator屬性string創(chuàng)建者是useRange屬性string使用范圍否language屬性string語(yǔ)種否version屬性string版本否#包格式“baseInfo”: 包基本信息 , “copyrightInfo”: 信息 , “contentFiles”: “Files”: 文件集合, “audioFiles”: 音頻文件集合, “imageFiles”: 圖片文件集合, “graphFiles”: 圖形文件集合, “scriptFiles”: 文稿集合, “otherFiles”: 其他文件集合“t

8、agItems”: 集合, “extendAttributes”: 擴(kuò)展屬性集合屬性格式1.3信息類型屬性說(shuō)明屬性含義類型說(shuō)明必填#包基本信息“pkGUID”：”string”, “title”: “string”,“origin”: “string”,“owner”: “string”,“creator”: “string”, “useRange”: “string”, “l(fā)anguage”: “string”, “version”: “string”, “createTime”: “string”, “revisionTime”: “string”, “status”: “string”,

9、 “mainFileGUID”: “string”, “mainFileType”: “string”, “description”: “string”createTime屬性string創(chuàng)建時(shí)間否revisionTime屬性string修訂時(shí)間否status屬性string包的狀態(tài)否mainFileGUID屬性string包中的主文件標(biāo)識(shí)否mainFileType屬性string包中的主文件類型：、Audio、Image、Graph、Script、Other否description屬性string包整體描述否屬性格式1.4文件類型屬性說(shuō)明屬性含義類型說(shuō)明必填FileType對(duì)象無(wú)文件類型是r

10、elationCode屬性string關(guān)系標(biāo)識(shí)（AndAudio、KeyFrame、HighLowBit 等）否#信息格式“materialOrigin”: “string”, “property”: “string”, “copyrightGrade”: “string”, “broadcastRights”: “string”, “distributionRights”: “string”, “period”: “string”copyrightInfo對(duì)象無(wú)信息類型是materialOrigin屬性string素材來(lái)源：、委托制作、制作、國(guó)內(nèi)采購(gòu)、海外引進(jìn)、交流、其他否property屬

11、性string屬性：、合作、僅有權(quán)、衍生否copyrightGrade屬性string等級(jí)：一級(jí)：可可作素材可開(kāi)發(fā)：可可作素材、三級(jí)：否broadcastRights屬性string權(quán)：地面頻道（有線、無(wú)線）、頻道、數(shù)字頻道、網(wǎng)絡(luò)寬頻、電視、移動(dòng)電視、航空、其他否distributionRights屬性string權(quán)：國(guó)內(nèi)模擬頻道（有線、無(wú)線、）、國(guó)內(nèi)新、國(guó)際模擬頻道、國(guó)際新否period屬性string年限否relationType屬性string關(guān)系類型（/音頻、/關(guān)鍵幀、高碼/低碼等）否md5屬性string文件 MD5 值是terminalType屬性string終端類型（包含 pc、

12、mb、ott）等否GUID屬性string文件唯一標(biāo)識(shí)否Name屬性string文件名稱是URL屬性string文件地址是Format屬性string文件格式否mediaType屬性string格式否Type集合string類型：高碼、低碼否column屬性string所屬欄目否compression屬性string壓縮格式否bitRate屬性string壓縮碼率(Kbps)否frameWidth屬性string畫面寬度否frameHeight屬性string畫面高度否resolution屬性string畫面寬高比（分辨率）否size屬性string素材大小(字節(jié))否frames屬性strin

13、g素材長(zhǎng)度(幀)否frameRate屬性string幀率(fps)否startPoint屬性string有效內(nèi)容的起始時(shí)間否duration屬性string持續(xù)時(shí)間（時(shí)長(zhǎng)）否Quality屬性string畫面質(zhì)量，如：標(biāo)清、超清否samplesFormat屬性string采樣格式否bitsPerPixel屬性string每像素位數(shù)否pixelFormat屬性string像素格式否dataRate屬性string數(shù)據(jù)碼率否scanMode屬性string掃描模式否gopSize屬性stringIBP 素材的 GOP 長(zhǎng)度否bFrameCount屬性stringB 幀個(gè)數(shù)否pFrameCount屬

14、性stringP 幀個(gè)數(shù)否natureSound屬性string同期聲否status屬性string文件狀態(tài)否dataContent屬性string內(nèi)容描述否isRelatedAudio屬性boolean是否有強(qiáng)關(guān)聯(lián)的音頻文件否isRelatedFrame屬性boolean是否有關(guān)鍵幀否markInfo集合markInfoType出入點(diǎn)集合否屬性格式#文件格式“relationCode”：”string”, “relationType”：”string”, “md5”：”string”, “terminalType”：“string”, “GUID”: “string”,“Name”: “st

15、ring”,“URI”: “string”,“Format”: “string”, “mediaType”: “string”, “Type”： “string”,“column”: “string”, “compression”: “string”, “bitRate”: “string”, “frameWidth”: “string”, “frameHeight”: “string”, “resolution”: “string”, “size”: “string”,“frames”: “string”, “frameRate”: “string”, “startPoint”: “stri

16、ng”, “duration”: “string”,“Quality”: “string”, “samplesFormat”: “string”, “bitsPerPixel”: “string”, “pixelFormat”: “string”,tagItems集合tagItemTypeTag集合否extendAttribute s集合extentionAttrib uteType擴(kuò)展屬性集合否1.5 音頻文件類型屬性說(shuō)明屬性含義類型說(shuō)明必填audioFileType對(duì)象無(wú)音頻文件類型是relationCode屬性string關(guān)系標(biāo)識(shí)（AndAudio、KeyFrame、HighLowBit

17、 等）否relationType屬性string關(guān)系類型（/音頻、/關(guān)鍵幀、高碼/低碼/轉(zhuǎn)碼等）否md5屬性string文件 MD5 值是audioGUID屬性string音頻文件唯一標(biāo)識(shí)否audioName屬性string音頻文件名稱是audioURL屬性string音頻文件地址是audioFormat屬性string音頻文件格式否mediaType屬性string格式否column屬性string所屬欄目否size屬性string素材大小(字節(jié))否“dataRate”: “string”, “scanMode”: “string”, “gopSize”: “string”, “bFrame

18、Count”: “string”, “pFrameCount”: “string”, “natureSound”: “string”, “status”: “string”, “dataContent”: “string”, “isRelatedAudio”: boolean, “isRelatedFrame”: boolean, “markInfo”: 出入點(diǎn)集合,“tagItems”: 集合, “extendAttributes”: 擴(kuò)展屬性集合屬性格式#音頻文件格式“relationCode”：”string”, “relationType”：”string”, “md5”：”strin

19、g”, “audioGUID”: “string”, “audioName”: “string”, “audioURI”: “string”, “audioFormat”: “string”, “mediaType”: “string”, “column”: “string”,“size”: “string”, “startPoint”: “string”, “duration”: “string”, “channelNumber”: “string”, “samplesRate”: “string”, “bitsPerSample”: “string”, “status”: “string”

20、, “dataContent”: “string”, “markInfo”: 音頻出入點(diǎn)集合,startPoint屬性string有效內(nèi)容起始時(shí)間否duration屬性string持續(xù)時(shí)間（時(shí)長(zhǎng)）否channelNumber屬性string聲道數(shù)否samplesRate屬性string音頻采樣率否bitsPerSample屬性string量化位數(shù)否status屬性string音頻文件狀態(tài)否dataContent屬性string內(nèi)容描述否markInfo集合markInfoType音頻出入點(diǎn)集合否tagItems集合tagItemTypeTag集合否extendAttribute s集合exte

21、ntionAttributeType擴(kuò)展屬性集合否1.6 圖片文件類型屬性說(shuō)明屬性含義類型說(shuō)明必填imageFileType對(duì)象無(wú)圖片文件類型是relationCode屬性string關(guān)系標(biāo)識(shí)（AndAudio、KeyFrame、HighLowBit 等）否relationType屬性string關(guān)系類型（/音頻、/關(guān)鍵幀、高碼/低碼/轉(zhuǎn)碼等）否md5屬性string文件 MD5 值是imageGUID屬性string圖片文件唯一標(biāo)識(shí)否imageName屬性string圖片文件名稱是imageURL屬性string圖片文件地址是imageFormat屬性string圖片文件格式否mediaTy

22、pe屬性string格式否imageWidth屬性string畫面寬度否imageHeight屬性string畫面高度否resolution屬性string分辨率否size屬性string圖片大小(字節(jié))否DPI屬性string打印分辨率否bitDepth屬性string位深度否dataContent屬性string內(nèi)容描述否tagItems集合TagItemTypeTag集合否extendAttribute s集合ExtentionAttributeType擴(kuò)展屬性集合否“tagItems”: 集合, “extendAttributes”: 擴(kuò)展屬性集合屬性格式1.7 圖形文件類型屬性說(shuō)明屬

23、性含義類型說(shuō)明必填graphFileType對(duì)象無(wú)圖形文件類型是relationCode屬性string關(guān)系標(biāo)識(shí)（AndAudio、KeyFrame、HighLowBit 等）否#圖片文件格式“relationCode”：”string”, “relationType”：”string”, “md5”：”string”, “imageGUID”: “string”, “imageName”: “string”, “imageURI”: “string”, “imageFormat”: “string”, “mediaType”: “string”, “imageWidth”: “string”

24、, “imageHeight”: “string”, “resolution”: “string”, “size”: “string”,“DPI”: “string”, “bitDepth”: “string”, “dataContent”: “string”, “tagItems”: 集合,“extendAttributes”: 擴(kuò)展屬性集合屬性格式#圖形文件格式“relationCode”：”string”, “relationType”：”string”, “md5”：”string”, “graphGUID”: “string”, “graphName”: “string”, “gra

25、phURI”: “string”, “graphFormat”: “string”, “mediaType”: “string”, “size”: “string”, “dataContent”: “string”, “tagItems”: 集合, “extendAttributes”: 擴(kuò)展屬性集合relationType屬性string關(guān)系類型（/音頻、/關(guān)鍵幀、高碼/低碼/轉(zhuǎn)碼等）否md5屬性string文件 MD5 值是graphGUID屬性string圖形文件唯一標(biāo)識(shí)否graphName屬性string圖形文件名稱是graphURL屬性string圖形文件地址是graphFormat

26、屬性string圖形文件格式否mediaType屬性string格式否size屬性string圖片大小(字節(jié))否dataContent屬性string內(nèi)容描述否tagItems集合tagItemTypeTag集合否extendAttributes集合extentionAttributeType擴(kuò)展屬性集合否1.8 文稿類型屬性說(shuō)明屬性含義類型說(shuō)明必填scriptFileType對(duì)象無(wú)文稿類型是relationCode屬性string關(guān)系標(biāo)識(shí)（AndAudio、KeyFrame、HighLowBit等）否relationType屬性string關(guān)系類型（/音頻、/關(guān)鍵幀、高碼/低碼/轉(zhuǎn)碼等）否m

27、d5屬性string文件 MD5 值是scriptGUID屬性string稿件的唯一標(biāo)識(shí)，可用 GUID 表示否scriptTitle屬性string稿件標(biāo)題是scriptName屬性string稿件名稱是ScriptURL屬性string稿件地址是scriptFormat屬性string稿件格式否mediaType屬性string格式否size屬性long稿件大小(字節(jié))是version屬性string稿件版本否type屬性string稿件類型：選題稿件、通稿、欄目稿件、空標(biāo)題否source屬性string稿件來(lái)源：路透稿件、回傳稿件等否author屬性string發(fā)稿人否publishTi

28、me屬性string發(fā)稿時(shí)間否broadcastTime屬性string時(shí)間否wordCount屬性string字?jǐn)?shù)否content屬性string稿件內(nèi)容否tagItems集合tagItemTypeTag集合否extendAttribute s集合extentionAttribute Type擴(kuò)展屬性集合否屬性格式1.9 其他文件類型屬性說(shuō)明屬性含義類型說(shuō)明必填otherFileType對(duì)象無(wú)其他文件類型是#文稿格式“relationCode”：”string”, “relationType”：”string”, “md5”：”string”, “scriptGUID”: “string”,

29、 “scriptTitle”: “string”, “scriptName”: “string”, “scriptURI”: “string”, “scriptFormat”: “string”, “mediaType”: “string”, “size”: long,“version”: “string”,“type”: “string”,“source”: “string”,“author”: “string”, “publishTime”: “string”, “broadcastTime”: “string”, “wordCount”: “string”, “content”: “st

30、ring”,“tagItems”: 集合, “extendAttributes”: 擴(kuò)展屬性集合屬性格式#其他文件格式“relationCode”：”string”, “relationType”：”string”, “md5”：”string”, “fileGUID”: “string”, “fileName”: “string”, “fileURI”: “string”, “fileFormat”: “string”, “size”: “string”, “dataContent”: “string”, “tagItems”: 集合,“extendAttributes”: 擴(kuò)展屬性集合re

31、lationCod e屬性string關(guān)系標(biāo)識(shí)（AndAudio、KeyFrame、HighLowBit 等）否relationType屬性string關(guān)系類型（/音頻/關(guān)鍵幀、高碼/低碼/轉(zhuǎn)碼等）否md5屬性string文件 MD5 值是fileGUID屬性string文件唯一標(biāo)識(shí)否fileName屬性string文件名稱是fileURL屬性string文件地址是fileFormat屬性string文件格式否size屬性string文件大小(字節(jié))否dataContent屬性string內(nèi)容描述否tagItems集合tagItemTypeTag集合否extendAttrib utes集合ex

32、tentionAttribute Type擴(kuò)展屬性集合否1.10 視音頻出入點(diǎn)類型屬性說(shuō)明屬性格式1.11 Tag類型屬性說(shuō)明屬性含義類型說(shuō)明必填tagItemType對(duì)象無(wú)Tag類型是tagName屬性string名稱否keyword屬性string關(guān)鍵字否tagTime屬性string時(shí)間否description屬性string描述否#出入點(diǎn)信息格式“markIn”: “string”,“markOut”: “string”, “markContent”: “string”屬性含義類型說(shuō)明必填markInfoType對(duì)象無(wú)出入點(diǎn)信息類型是markIn屬性string入點(diǎn)否markOut屬性

33、string出點(diǎn)否markContent屬性string標(biāo)記內(nèi)容否屬性格式1.12 擴(kuò)展屬性類型屬性說(shuō)明屬性格式#擴(kuò)展屬性格式“itemCode”: “string”, “itemName”: “string”, “value”: “string”屬性含義類型說(shuō)明必填extentionAttributeType對(duì)象無(wú)擴(kuò)展屬性類型是itemCode屬性string擴(kuò)展項(xiàng)標(biāo)識(shí)否itemName屬性string擴(kuò)展項(xiàng)名稱否value屬性string擴(kuò)展項(xiàng)取值否#Tag格式“tagName”: “string”,“keyword”: “string”,“tagTime”: “string”, “des

34、cription”: “string”第2章 調(diào)用說(shuō)明2.1 概述歡迎使用荔枝云-PaaS 平臺(tái)云服務(wù)。用戶可以使用本文檔介紹的 API 對(duì)荔枝云-PaaS 平臺(tái)云服務(wù)進(jìn)行相關(guān)操作。對(duì)于接口的首先要獲取令牌，每次請(qǐng)求都需要驗(yàn)證令牌信息，如果超過(guò)兩個(gè)小時(shí)沒(méi)有使用，令牌信息將過(guò)期，需要重新申領(lǐng)令牌。對(duì)荔枝云-PaaS 平臺(tái)接口調(diào)用是通過(guò)向荔枝云-PaaS 平臺(tái)的服務(wù)端地址HTTPPOST 請(qǐng)求，并按照接口說(shuō)明在請(qǐng)求中加入相應(yīng)請(qǐng)求參數(shù)；根據(jù)請(qǐng)求的處理情況，系統(tǒng)會(huì)返回處理結(jié)果。2.2 請(qǐng)求結(jié)構(gòu)說(shuō)明請(qǐng)求地址荔枝云-PaaS 平臺(tái)的服務(wù)接入地址規(guī)則：http:/公共參數(shù)接口地址地址由三部分組成：域名：服務(wù)

35、所提供的內(nèi)容。公共參數(shù)：參考公共參數(shù)說(shuō)明中的內(nèi)容說(shuō)明，由系統(tǒng)統(tǒng)一進(jìn)行分配，用戶調(diào)用接口時(shí)按分配的內(nèi)容進(jìn)行填寫。接口地址：服務(wù)提供的內(nèi)容。注：所有參數(shù)項(xiàng)必須傳遞，非必填項(xiàng)的值可為空，所有參數(shù)區(qū)分大小寫。請(qǐng)求及返回結(jié)果都使用 UTF-8 字符集進(jìn)行編碼。公共參數(shù)地址示例獲取令牌的接口地址。http:/appCode/versionId/companyId/userId/serviceCode/auth/token/getAccessToken/【第一部分】【第二部分】接口地址分為兩個(gè)部分，第一部分是公共請(qǐng)求參數(shù)，必含項(xiàng)。第二部分是具體服務(wù)的接口地址。2.3 返回結(jié)果“code”:”,#狀態(tài)碼, 參

36、照附錄“message”:”,#描述信息“data”:“key”:”value”,“key”:”value”#結(jié)果數(shù)據(jù)，詳情查看各接口返回參數(shù)屬性含義類型說(shuō)明必填appCode應(yīng)用標(biāo)識(shí)String應(yīng)用唯一標(biāo)識(shí)（由荔枝云平臺(tái)提供）是versionId版本號(hào)String接口版本號(hào)，當(dāng)前版本號(hào)為 V1是companyId企業(yè)標(biāo)識(shí)String企業(yè)唯一標(biāo)識(shí)（由荔枝云平臺(tái)提供）是userId用戶標(biāo)識(shí)String用戶唯一標(biāo)識(shí)（用戶填充）是serviceCode服務(wù)類型標(biāo)識(shí)String服務(wù)類型唯一標(biāo)識(shí)（由荔枝云平臺(tái)提供）是第3章 接口認(rèn)證3.1 獲取令牌功能描述荔枝云-PaaS 平臺(tái)的服務(wù)會(huì)對(duì)每個(gè)的請(qǐng)求進(jìn)行驗(yàn)

37、證，需要在請(qǐng)求中帶上令牌信息。此接口是以 OAuth2.0 模式實(shí)現(xiàn)認(rèn)證和。令牌的獲取方式：用戶傳遞的應(yīng)用標(biāo)識(shí)、版本號(hào)、企業(yè)標(biāo)識(shí)、服務(wù)標(biāo)識(shí)、密鑰和時(shí)間戳生成相應(yīng)的令牌，該令牌有效時(shí)長(zhǎng)為 2 小時(shí)。接口地址auth/token/getAccessToken/請(qǐng)求參數(shù)返回參數(shù)請(qǐng)求示例POST屬性含義類型說(shuō)明accessToken令牌String有時(shí)效性的令牌屬性含義類型說(shuō)明必填accessKey密鑰String密鑰（此密鑰由荔枝云平臺(tái)提供，需）是timeStamp時(shí)間戳String請(qǐng)求接口時(shí)，請(qǐng)求方當(dāng)前時(shí)間毫秒數(shù)是返回示例3.2服務(wù)狀態(tài)碼列表代碼描述說(shuō)明0Success操作1Authorizati

38、on fail獲取失敗“code”:“0”,“message”:“”, “data”：“accessToken”:”05784E32D86340D976677714905E6D53B2E041F124A3D1603BAAD66E21880EE5”/appCode/versionId/companyId/userId/serviceCode/auth/token/getAccessTok en/User-Agent: curl/7.12.1 (x86_64-redhat-linux-gnu) libcurl/7.12.1 OpenSSL/0.9.7a zlib/ libidn/0.

39、5.6Pragma: no-cache Accept: */*Host:Content-Type:application/x-www-form-urlencoded Content-Length:XaccessKey=0A3D1603BAAD66E21880EE5&timeStamp=1435642027第4章 媒資服務(wù)4.1注入FTP 上傳1)功能描述向用戶提供 ftp 服務(wù)，供用戶執(zhí)行上傳多文件。ftp 服務(wù)信息由荔枝云平臺(tái)提供。用戶首先將、音頻、圖片、文稿等類型通過(guò) ftp 方式上傳到指定目錄；在進(jìn)行時(shí)，對(duì)應(yīng)的地址填寫為 ftp路徑。2)接口地址ftp:/用戶名:ip3)參數(shù)說(shuō)明

40、斷點(diǎn)續(xù)傳l 獲取令牌1)功能描述參數(shù)含義類型說(shuō)明必填ftpUser用戶名StringFTP 服務(wù)的用戶名（由荔枝云平臺(tái)提供）是ftpPwdStringFTP 服務(wù)的（由荔枝云平臺(tái)提供）是ip服務(wù)器ip 地址StringFTP 服務(wù)器 ip 地址（由荔枝云平臺(tái)提供）是根據(jù)用戶提供的素材名稱、素材大?。ㄗ止?jié)數(shù)）、公共參數(shù)信息，獲取素材斷點(diǎn)續(xù)傳的上傳令牌 。獲取素材上傳令牌時(shí)，必須首先獲取令牌（見(jiàn)獲取令牌），令牌保證當(dāng)前請(qǐng)求的有效性。2)接口地址rms/material/getUploadToken/3)參數(shù)說(shuō)明4)返回參數(shù)5)請(qǐng)求示例POST/rms/upload/getUploadToken/U

41、ser-Agent: curl/7.12.1 (x86_64-redhat-linux-gnu) libcurl/7.12.1 OpenSSL/0.9.7a zlib/ libidn/0.5.6Pragma: no-cache Accept: */*參數(shù)含義類型說(shuō)明uploadToken上傳令牌String上傳令牌參數(shù)含義類型說(shuō)明必填accessToken令牌String獲取令牌接口返回的令牌是timeStamp時(shí)間戳String請(qǐng)求接口時(shí)，請(qǐng)求方當(dāng)前時(shí)間毫秒數(shù)是materialName素材名稱String名稱是materialLengt h素材大小String大小是appCod

42、e應(yīng)用標(biāo)識(shí)String應(yīng)用標(biāo)識(shí)（由荔枝云平臺(tái)提供）是versionId版本號(hào)String當(dāng)前版本號(hào)（默認(rèn)為 v1）是companyId標(biāo)識(shí)String標(biāo)識(shí)（由荔枝云平臺(tái)提供）是userId用戶標(biāo)識(shí)String用戶標(biāo)識(shí)是serviceCode服務(wù)標(biāo)識(shí)String服務(wù)標(biāo)識(shí)（由荔枝云平臺(tái)提供）是6)返回示例l 文件上傳1)功能描述進(jìn)行文件上傳時(shí)，必須首先獲取請(qǐng)求的有效性。令牌（見(jiàn)獲取令牌），令牌保證當(dāng)前其次調(diào)用斷點(diǎn)續(xù)傳之獲取上傳令牌協(xié)議（見(jiàn)斷點(diǎn)續(xù)傳）獲取上傳令牌。然后根據(jù)用戶提供的上傳令牌、公共參數(shù)信息與文件流，實(shí)現(xiàn)文件斷點(diǎn)續(xù)能。2)接口地址rms/material/uploadStream/3)參

43、數(shù)說(shuō)明“code”:“0”,#狀態(tài)碼，參照附錄“message”:“”,#描述信息“data”：“uploadToken”:” a23ssdfg123456sdf4567s34523” #上傳令牌Host:Content-Type:application/x-www-form-urlencoded Content-Length:XaccessToken=05784E32D86340D976677714905E6D53B2E041F124A3D1603BAAD66E21880EE5&timeStamp=1435642027&materialName=中國(guó)歷史&materi

44、alLength=3041088&appCode=api&versionId=3.0&companyId=54c6f 3022a80fc1e70ff553b&userId=54c6f9582a80fc1e70ff5575&serviceCode=vms4)返回參數(shù)5)請(qǐng)求示例6)返回示例POST/rms/material/getUploadProgress/User-Agent: curl/7.12.1 (x86_64-redhat-linux-gnu) libcurl/7.12.1 OpenSSL/0.9.7a zlib/ libidn/

45、0.5.6Pragma: no-cache Accept: */*Host:Content-Type:multipart/form-data Content-Length:XaccessToken=05784E32D86340D976677714905E6D53B2E041F124A3D1603BAAD66E21880EE5&timeStamp=1435642027&uploadToken=A869055733_3041088_54c6f9582a80fc1e70ff5575&appCode=api&versionId=3.0&companyId=54c6