注: 为了用户的选座数据能够被美团联盟记录到,站长需要将下列接口中所有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 参数: