点评微生活_商家API0909.doc

API文档 目录 接口说明 2 每个接口对应一个唯一的url 2 调用方式 2 参数格式 2 POST 参数 2 返回结果 2 常见错误码 3 正确返回示例 3 异常返回示例 3 方法示例 3 获取用户基本信息 3 /user/auth 3 附录1：sig 生成规则 4 附录2：API调用流程 6 积分接口 8 积分兑换礼物 8 交易接口 9 交易预览 9 交易提交 11 交易冲正 12 交易撤销 13 设置接口 13 获取收银员列表 13 用户接口 14 验证登录 14 获取用户账户信息 15 优惠券接口 16 发券 16 活动列表 17  接口说明 每个接口对应一个唯一的url /user/list 调用方式 以 Restful Service 的方式提供接口调用。 参数格式 通过 post方式传递数据。 POST 参数 变量名 说明 req 各个请求方法对应的参数 ts 发起请求的时间戳 fmt 结果返回的数据格式，暂时只支持 JSON appid 客户端名称，字符串 sig 通过参数和密钥生成的加密字符串。生成规则见附录 v 调用接口的版本 返回结果 接口返回数据为一个数组，包含三个键值： 键值 说明 errcode 错误码。0 表示正常返回，否则表示有异常 errmsg 错误说明。异常说明信息 res 请求方法执行结果 常见错误码 代码 说明 1001 参数错误 1002 数据的签名验证异常 1003 未知的系统异常 1004 该接口目前无法调用 3001 未知的 cno 3002 指定的会员不存在 3003 未知的 cashier_id 正确返回示例 {errcode:0,errmsg:OK,res:{wlid:12201135853160167267,type:dianping,sex:1} 异常返回示例 {errcode:10003,errmsg: sig verification error ,res:null} 方法示例 获取用户基本信息 /user/auth 方法说明 验证登录台，并获取用户的基本信息 Post参数 键名 数据类型 说明 wl_token string 前端页面获取到的 返回结果 索引数组，商品列表信息，每个元素具体返回字段如下表所示 键名 数据类型 说明 cno int 卡号 phone int 手机号 name string 名字 sex int 性别 1 男 2 女 0 未知 grade int 等级 balance int 储值余额 credit int 积分 附录1：sig 生成规则 前提 从商家后台获取客户端和服务端通信加密使用的appkey，一个appid对应一个appkey。 生成规则 将参数数组按照key升序(递归，子数组也要排序) 排序后的数组生成查询字符串(键值对需要urlencode) 依次连接appid，appkey，版本号，时间戳 md5 示例： =1limit=20offset=0orderby%5Bbalance%5D=desc 依次连接appid，appkey，， grade=1limit=20offset=0orderby%5Bbalance%5D=descappid=ct_ZjQ4NmU2OTE0OGY1MTJappkey= 202cb962ac59075b964b07152d234b70v=1.0ts=1426773603 md5以后得到sig 51bdc1dd175c5f2d973e392bfa412ef7 因此本次POST请求需要传的参数为： req={grade:1,limit:20,offset:0,”orderby”:{“balance”:”desc”}}appid= ct_ZjQ4NmU2OTE0OGY1MTJv=1.0ts=1426840526sig= 51bdc1dd175c5f2d973e392bfa412ef7fmt=JSON 附录2：shop_id 获取方式在点评网站上面，商家自己的门店页面：/shop最后的数字就是此门店的shop_id 积分接口 积分兑换礼物 /credit/exchange 方法说明 仅限于积分兑换礼物，记录会在兑换记录处显示 Post参数 键名 数据类型 说明 长度 是否必填 uid int 微生活用户UID - 是 cashier_id int 收银员ID - 是 sub_credit int 扣减的积分数 5 是 desc string 兑换的礼物详情 50 是 biz_id string 业务号 30 是 返回结果 键名 数据类型 说明 uid int 微生活用户UID biz_