VMS接口协议文档

1、VMS系统接口协议（草稿）1.概述VMS系统接口协议如下：接口类型：请求采用 HTTP协议提交，请求方法为 POST或GET方式。 返回参数描述：返回参数名描述status调用接口返回结果，0:操作成功； 其它值表示失败。message返回结果对应的描述信息。result操作返回的详细内容，如查询结果列表内容。0成功。-1失败:参数小止确。-2失败：接口发生异常。20失败:参数小止确。30失败：内容不存在。40失败：内容信息不完整。返回结果描述返回值描述response<?xml version="1.0" encoding="UTF-8"?>

2、;response ><status>0</status>message他作成功 </message><$datanode>XXXXXXXXXXXX</$datanode></response>其中$datanode返回数据的父节点，用于客户端解析，统一使用vmsdata节点组织内容2 .影片基本信息接口接口类型：请求采用HTTP协议提交。接口 url： http:/host:port/app name/ clientapi/getBaseInfo 接口参数名：参数名描述ContentID内容标识（必填）<vm

3、sdata>节点描述:返回节点值返回节点描述contentID内容标识name内容名称eName内容英文名称director导演，多个用逗号隔开actors主演，多个用逗号隔开publishDate出品时间contentType内容类型language电影语言publishArea出品地区duration电影片长tags标签1,标签2 （中间用半角逗号分隔）salePoint影片亮点描述desc剧情介绍picUrl（用urldecode下,中间用|分隔，如果是电视剧则为分集剧昭）八、JplayUrl播放地址用urldecode,多个的话用|分隔开guidUuid编号（废弃）spid服务商

4、标识playCounts播放次数lastUser观看人数saveCounts收藏次数postCounts评论次数avgSorce评论总分（打分总数/人次）3 .观看过某影片的用户信息接口接口类型：请求采用HTTP协议提交。接口 url: http:/host:port/app name/ clientapi/getUsernfoBylD 接口参数名：参数名描述ContentID内容标识（必填）<vmsdata>节点描述:返回节点值返回节点描述lastUser最后观看影片的四位用户信息，返回结果详细信息见下。注：每位用户信息都以< vmsdata >开始，</ vm

5、sdata >结束。多位用户组成多个<vmsdata>。如：<vmsdata ><userID>XXX</ userID ><userName >XXX</ userName ></ vmsdata ><vmsdata >< userID >XXX</ userID ><userName >XXX</userName ></ vmsdata >4 .影片播放后接口接口类型：请求采用HTTP协议提交。接口 url: http:/host

6、:port/app name/ clientapi/savePlayUserInfo 接口参数名：参数名描述ContentID内容标识（必填）UserID观看用户ID （必填）UserName观看用户名称（必填）PlayTime播放时间（必填）<vmsdata>节点描述:返回节点值返回节点描述无无5 .推荐影片接口接口类型：请求采用HTTP协议提交。接口 url: http:/host:port/app name/ clientapi/getRuleMovieInfo 接口参数名：参数名描述RuleType推荐类型（必填）（详细信息见 9.推荐类型备注）MovieNumber影片个

7、数（必填）<vmsdata>节点描述:返回节点值返回节点描述contentID内容IDname电影中文名称picUrl海报地址salePoint亮点playUrl影片地址director导演，多个用逗号隔开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 >结束。多部影片组成多个6.编目影片接口接口类型：请求采用HTTP协议提交。接口 url: http:/host:port/app na

9、me/ clientapi/getCataLogMovieInfo 接口参数名：参数名描述CatalogType编目类型（必填）（详细信息见10编目类型备注）StartIndex起始索引号（如果IsParent为1,此字段不做判断使用）RowNum一次取得影片个数 （如果IsParent为1,此字段不做判断使 用）IsParent0：子节点（影片总数）；1：父节点（影片内容信息）返回节点描述：（1） .当 IsParent 为 0 时,<totalNumber>节点描述返回节点值返回节点描述totalNumber"影片总数<vmsdata>节点描述:返回节点值

10、返回节点描述contentID内容IDname电影中文名称picUrl海报地址salePoint亮点playUrl影片地址totalNumber影片总数（2） .当 IsParent 为 1 时,返回节点值返回节点描述catalogID编目IDcatalogName编目名称IsParent 为 0 时如：每部影片信息都以 < vmsdata >开始，</ vmsdata >结束。多部影片组成多个<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协议提交。接口 url: http:/host:port/appname/ clientapi/getSeenMovieInfo 接口参数名：参数名描述UserID用户IDRowNum一次取得影片个数<vmsdata>节点描述:返回节点值|返回节点描述con

13、tentID内容IDcontentName内容名称viewTime观看时间contentLink影片链接8 .用户交互接口接口类型：请求采用HTTP协议提交。接口 url: http:/host:port/app name/ clientapi/customerService 接口参数名：参数名描述UserID用户IDContentID内容IDServiceType交互类型（0:评论；1:评分；2:印象）DetailInfo父互内容<vmsdata>节点描述:返回节点值返回节点描述无无9 .推荐类型备注推荐类型值类型描述homePageAll首页推荐-规则随机显示一组高清影片信息-

14、不分 电视剧和电影homepageMoviehomepageSerial首页推荐-规则随机显示一组高清影片信息-只有 电影首页推荐-规则随机显示一组高清影片信息-只有 电视剧homepageOldMovie经典怀旧-规则随机显示一组高清影片信息-只有电影homepageOldSerial经典怀旧-规则随机显示一组高清影片信息-只有电视剧movieChartsDay电影排行榜-按天movieChartsWeek电影排行榜-按周movieChartsAll电影排行榜-所有serialChartsDay电视剧排行榜至天serialChartsWeek电视剧排行榜上周serialChartsAll电视剧排行榜-所有hotMovie显示后台设置的电影hotSerial显示后台设置的电视剧newMovie显示后台设置的电影newSerial显示后台设置的电视剧istChineseMovieDay电影华语排行榜-按天listChineseMovieWeek电影华语排行榜-按周listEuropeMovieDay电影欧美排行榜-按天listEuropeMovieWeek电影欧美