当前位置:文档之家› 猫眼选座API使用说明

猫眼选座API使用说明

注: 为了用户的选座数据能够被美团联盟记录到,站长需要将下列接口中所有seatUrl中得url需要按照下列方式拼接得到最终的选座广告跳转链接:

https://www.doczj.com/doc/4214683536.html,/url/visit/?key=usersign&url=seatUrl",

(usersign是站长在联盟前台点击获取广告时地址栏显示的"usersign/"后面的内容;

seatUrl是通过下列接口获取的选座链接)

示例:

https://www.doczj.com/doc/4214683536.html,/url/visit/?key=h645jkh3k4h5j&url=https://www.doczj.com/doc/4214683536.html,/xuan zuo/shop/796845/show/201307180000043/seats

1. 错误代码说明

通常情况下,http code 为4XX 或5XX 的时候表示请求有错误发生。

但是,只要返回一个error 对象就说明有错误发生,即便请求返回的http code是200

code 通常和http code 相等。

type 相当于错误异常的简要标识(ExceptionName)

401 Unauthorized 签名有误

403 RequestCountLimited 请求次数受限,请稍后再试

403 Forbidden method {?}不存在或禁止访问

response的应答code也会置相同的code

2. 接口安全性

2.1. 签名验证

签名验证,基于md5方法。

请求示例:

请求URL: POST

https://www.doczj.com/doc/4214683536.html,/dianying/cinemas.json?uuid=3da5e76f286ac0fc9740112cfd935c6b8 8206bdfdd9929d79f12d089

bc0e6c63

表单内容:

...

Header中内容:

Token: ""

Date: Fri, 23 Nov 2012 06:45:38 GMT

Authorization:d727f9ef18f1620c4c1be6811779946e

Key:adesedfd

md5加密规则:

Authorization=MD5(对(clientId + keyValues + clientSecret + token+ clientSecret + httpMethod + clientSecret + date + clientId)全部转大写得到的串)

String md5 = DigestUtils.md5Hex((clientId + keyValues + clientSecret + token+ clientSecret + httpMethod + clientSecret + date + clientId).toUpperCase());

服务端重新生成的md5值和客户端上传的值,两者相同的话通过验证,否则返回401错误clientId(32位):

单独提供

clientSecret(128位):

单独提供

2.2. 频率限制

目前限制是每分钟1000次, 超过频率限制会返回403

3. API接口

接口地址:https://www.doczj.com/doc/4214683536.html,/open/maoyan

Http请求,返回数据的格式为json格式

3.1. 获取城市列表

Url:

/v1/cities.json

参数:

返回值:

3.2. 获取城市影院列表Url:

/v1/cinemas.json

参数:

3.3. 获取正在上映电影Url:

/v1/movies.json

参数:

3.4. 请求影院某日影讯Url:

/v1/cinema/{cinemaId}/shows.json 参数:

3.5. 根据影片获取上映影院的场次Url:

/v1/movie/{movieId}/shows.json

参数:

3.6. 根据影院获取上映电影和场次Url:

/v1/cinema/{cinemaId}/movies/shows.json 参数:

相关主题
文本预览
相关文档 最新文档