猫眼选座API使用说明.doc

猫眼选座API使用说明.doc注: 为了用户的选座数据能够被美团联盟记录到,站长需要将下列接口中所有seatUrl中得url需要按照下列方式拼接得到最终的选座广告跳转链接:
./url/visit/?key=usersign&url=seatUrl",
(usersign是站长在联盟前台点击获取广告时地址栏显示的"usersign/"后面的内容;
seatUrl 是通过下列接口获取的选座链接)
示例:./url/visit/?key=h645jkh3k4h5j&url=http://maoyan./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. 接口安全性
. 签名验证
签名验证,基于md5方法。
签名验证机制需要调用方提供以下字段:
名称
类型
说明
keyValues
String
get请求时为"",post请求中的表单内容(不包括?后的查询参数),需要参数对key-value按key升序排序,形式如"a=123&b=321&c=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/?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 = ((clientId + keyValues + clientSecret + token+ clientSecret + httpMethod + clientSecret + date + clientId).toUpperCase());
服务端重新生成的md5值和客户端上传的值,两者相同的话通过验证,否则返回401错误
clientId(32位):
单独提供
clientSecret(128位):
单独提供
. 频率限制
目前限制是每分钟1000次, 超过频率限制会返回403
3. API接口
接口地址:./open/maoyan
Http请求,返回数据的格式为json