VMS接口協(xié)議文檔

1、VMS系統(tǒng)接口協(xié)議（草稿）1.概述VMS系統(tǒng)接口協(xié)議如下：接口類型：請求采用 HTTP協(xié)議提交，請求方法為 POST或GET方式。 返回參數(shù)描述：返回參數(shù)名描述status調(diào)用接口返回結(jié)果，0:操作成功； 其它值表示失敗。message返回結(jié)果對應(yīng)的描述信息。result操作返回的詳細內(nèi)容，如查詢結(jié)果列表內(nèi)容。0成功。-1失敗:參數(shù)小止確。-2失?。航涌诎l(fā)生異常。20失敗:參數(shù)小止確。30失?。簝?nèi)容不存在。40失?。簝?nèi)容信息不完整。返回結(jié)果描述返回值描述response<?xml version="1.0" encoding="UTF-8"?>

2、;response ><status>0</status>message他作成功 </message><$datanode>XXXXXXXXXXXX</$datanode></response>其中$datanode返回數(shù)據(jù)的父節(jié)點，用于客戶端解析，統(tǒng)一使用vmsdata節(jié)點組織內(nèi)容2 .影片基本信息接口接口類型：請求采用HTTP協(xié)議提交。接口 url： http:/host:port/app name/ clientapi/getBaseInfo 接口參數(shù)名：參數(shù)名描述ContentID內(nèi)容標識（必填）<vm

3、sdata>節(jié)點描述:返回節(jié)點值返回節(jié)點描述contentID內(nèi)容標識name內(nèi)容名稱eName內(nèi)容英文名稱director導(dǎo)演，多個用逗號隔開actors主演，多個用逗號隔開publishDate出品時間contentType內(nèi)容類型language電影語言publishArea出品地區(qū)duration電影片長tags標簽1,標簽2 （中間用半角逗號分隔）salePoint影片亮點描述desc劇情介紹picUrl（用urldecode下,中間用|分隔，如果是電視劇則為分集劇昭）八、JplayUrl播放地址用urldecode,多個的話用|分隔開guidUuid編號（廢棄）spid服務(wù)商

4、標識playCounts播放次數(shù)lastUser觀看人數(shù)saveCounts收藏次數(shù)postCounts評論次數(shù)avgSorce評論總分（打分總數(shù)/人次）3 .觀看過某影片的用戶信息接口接口類型：請求采用HTTP協(xié)議提交。接口 url: http:/host:port/app name/ clientapi/getUsernfoBylD 接口參數(shù)名：參數(shù)名描述ContentID內(nèi)容標識（必填）<vmsdata>節(jié)點描述:返回節(jié)點值返回節(jié)點描述lastUser最后觀看影片的四位用戶信息，返回結(jié)果詳細信息見下。注：每位用戶信息都以< vmsdata >開始，</ vm

5、sdata >結(jié)束。多位用戶組成多個<vmsdata>。如：<vmsdata ><userID>XXX</ userID ><userName >XXX</ userName ></ vmsdata ><vmsdata >< userID >XXX</ userID ><userName >XXX</userName ></ vmsdata >4 .影片播放后接口接口類型：請求采用HTTP協(xié)議提交。接口 url: http:/host

6、:port/app name/ clientapi/savePlayUserInfo 接口參數(shù)名：參數(shù)名描述ContentID內(nèi)容標識（必填）UserID觀看用戶ID （必填）UserName觀看用戶名稱（必填）PlayTime播放時間（必填）<vmsdata>節(jié)點描述:返回節(jié)點值返回節(jié)點描述無無5 .推薦影片接口接口類型：請求采用HTTP協(xié)議提交。接口 url: http:/host:port/app name/ clientapi/getRuleMovieInfo 接口參數(shù)名：參數(shù)名描述RuleType推薦類型（必填）（詳細信息見 9.推薦類型備注）MovieNumber影片個

7、數(shù)（必填）<vmsdata>節(jié)點描述:返回節(jié)點值返回節(jié)點描述contentID內(nèi)容IDname電影中文名稱picUrl海報地址salePoint亮點playUrl影片地址director導(dǎo)演，多個用逗號隔開actors主演，多個用逗號隔開如：每部影片信息都以< vmsdata >開始,<vmsdata>。如：<vmsdata ><name>XXX</name><picUrl >XXX</picUrl ><salePoint >XXX</salePoint ><playU

8、rl >XXX<playUrl ></ vmsdata ><vmsdata ><name>XXX</name><picUrl >XXX</picUrl ><salePoint >XXX</salePoint ><playUrl >XXX<playUrl ></ vmsdata ></ vmsdata >結(jié)束。多部影片組成多個6.編目影片接口接口類型：請求采用HTTP協(xié)議提交。接口 url: http:/host:port/app na

9、me/ clientapi/getCataLogMovieInfo 接口參數(shù)名：參數(shù)名描述CatalogType編目類型（必填）（詳細信息見10編目類型備注）StartIndex起始索引號（如果IsParent為1,此字段不做判斷使用）RowNum一次取得影片個數(shù) （如果IsParent為1,此字段不做判斷使 用）IsParent0：子節(jié)點（影片總數(shù)）；1：父節(jié)點（影片內(nèi)容信息）返回節(jié)點描述：（1） .當 IsParent 為 0 時,<totalNumber>節(jié)點描述返回節(jié)點值返回節(jié)點描述totalNumber"影片總數(shù)<vmsdata>節(jié)點描述:返回節(jié)點值

10、返回節(jié)點描述contentID內(nèi)容IDname電影中文名稱picUrl海報地址salePoint亮點playUrl影片地址totalNumber影片總數(shù)（2） .當 IsParent 為 1 時,返回節(jié)點值返回節(jié)點描述catalogID編目IDcatalogName編目名稱IsParent 為 0 時如：每部影片信息都以 < vmsdata >開始，</ vmsdata >結(jié)束。多部影片組成多個<vmsdata>。如：<totalNumber>X<totalNumber><vmsdata ><name>XXX&

11、lt;/name><picUrl >XXX</picUrl ><salePoint >XXX</salePoint ><playUrl >XXX<playUrl ></ vmsdata ><vmsdata ><name>XXX</name><picUrl >XXX</picUrl ><salePoint >XXX</salePoint ><playUrl >XXX<playUrl ></ vm

12、sdata >IsParent 為 1 時<vmsdata ><catalogID >XXX</catalogID ><catalogName >XXX</catalogName ></ vmsdata >7 .我看過影片接口接口類型：請求采用HTTP協(xié)議提交。接口 url: http:/host:port/appname/ clientapi/getSeenMovieInfo 接口參數(shù)名：參數(shù)名描述UserID用戶IDRowNum一次取得影片個數(shù)<vmsdata>節(jié)點描述:返回節(jié)點值|返回節(jié)點描述con

13、tentID內(nèi)容IDcontentName內(nèi)容名稱viewTime觀看時間contentLink影片鏈接8 .用戶交互接口接口類型：請求采用HTTP協(xié)議提交。接口 url: http:/host:port/app name/ clientapi/customerService 接口參數(shù)名：參數(shù)名描述UserID用戶IDContentID內(nèi)容IDServiceType交互類型（0:評論；1:評分；2:印象）DetailInfo父互內(nèi)容<vmsdata>節(jié)點描述:返回節(jié)點值返回節(jié)點描述無無9 .推薦類型備注推薦類型值類型描述homePageAll首頁推薦-規(guī)則隨機顯示一組高清影片信息-

14、不分 電視劇和電影homepageMoviehomepageSerial首頁推薦-規(guī)則隨機顯示一組高清影片信息-只有 電影首頁推薦-規(guī)則隨機顯示一組高清影片信息-只有 電視劇homepageOldMovie經(jīng)典懷舊-規(guī)則隨機顯示一組高清影片信息-只有電影homepageOldSerial經(jīng)典懷舊-規(guī)則隨機顯示一組高清影片信息-只有電視劇movieChartsDay電影排行榜-按天movieChartsWeek電影排行榜-按周movieChartsAll電影排行榜-所有serialChartsDay電視劇排行榜至天serialChartsWeek電視劇排行榜上周serialChartsAll電視劇排行榜-所有hotMovie顯示后臺設(shè)置的電影hotSerial顯示后臺設(shè)置的電視劇newMovie顯示后臺設(shè)置的電影newSerial顯示后臺設(shè)置的電視劇istChineseMovieDay電影華語排行榜-按天listChineseMovieWeek電影華語排行榜-按周listEuropeMovieDay電影歐美排行榜-按天listEuropeMovieWeek電影歐美