猫眼选座API使用说明.docVIP

注: 为了用户的选座数据能够被美团联盟记录到，站长需要将下列接口中所有seatUrl中得url需要按照下列方式拼接得到最终的选座广告跳转链接： /url/visit/?key=usersignurl=seatUrl, (usersign是站长在联盟前台点击获取广告时地址栏显示的usersign/后面的内容; seatUrl 是通过下列接口获取的选座链接) 示例：/url/visit/?key=h645jkh3k4h5jurl=/xuanzuo/shop/796845/show/201307180000043/seats 1. 错误代码说明 通常情况下，http code 为 4XX 或 5XX 的时候表示请求有错误发生。 但是，只要返回一个error 对象就说明有错误发生，即便请求返回的http code是200 code 通常和 http code 相等。 type 相当于错误异常的简要标识（ExceptionName） message 是详细说明 { error : { code : 401, /* code code type message */ type : PermissionDenied, /* type*/ message : /*typetypetitlemessagebody */ } } code type message 401 Unauthorized 签名有误 403 RequestCountLimited 请求次数受限,请稍后再试 403 Forbidden method {?}不存在或禁止访问 response的应答code也会置相同的code 2. 接口安全性 2.1. 签名验证 签名验证，基于md5方法。 签名验证机制需要调用方提供以下字段： 名称 类型 说明 keyValues String get请求时为，post请求中的表单内容(不包括?后的查询参数)，需要参数对key-value按key升序排序,形式如a=123b=321c=213 token String 暂时为 httpMethod String Http请求的方法，GET/POST/PUT... (不用客户端上传) date String HTTP请求头中的Date域，格式如(Fri, 23 Nov 2012 06:45:38 GMT),建议使用格林尼治标准时间 (必需) authorization String 根据以上内容和特定规则生成的md5串，放在放在Header的Authorization字段中 (必需) key String 客户端的clientId 请求示例： 请求URL: POST /dianying/cinemas.json?uuid=3da5e76f286ac0fc9740112cfd935c6b88206bdfdd9929d79f12d089 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接口 接口地址：/open/maoyan Http请求，返回数据的格式为json格式 3.1. 获取城市列表 Url： /v1/cities.json 参数： 无 返回值: { data: [ {