商城后台接口说明文档(App)V1.2
徐家汇商城后台接口说明文档
V.1.0
2015/1/2
版本历史
目录
一、接口描述: (6)
二、注册登录相关接口 (7)
（1）手机快速用户注册接口(register) (7)
（2）登录接口(login) (8)
（3）第三方账号登录接口(thirdPartyLogin) (8)
（4）会员修改密码接口(updatePwd) (9)
（5）推出登录接口(logout) (9)
三、商品接口 (10)
（1）查询商家接口(queryMerchant) (10)
（2）查询商家下柜台列表接口(queryMerchantCounterList) (11)
（3）查询商品接口(queryProduct) (11)
（4）查询商品规格参数列表接口(queryProductSpecificationList) (12)
（5）查询品牌介绍接口(queryBrandPresent) (13)
（6）查询商品介绍接口(queryProductPresent) (14)
（7）查询商品详情接口(queryProductDetail) (15)
（8）查询品牌分类列表接口(queryBrandSortList) (16)
（9）查询品牌分类下属品牌列表接口(queryBrandByMerchantList) (17)
（10）查询品牌分类品牌归属商家列表接口(queryMallByMerchantList) (18)
（11）查询品牌商家柜台详情接口(queryMerchantDetail) (18)
（12）查询柜台下商品列表接口(queryCounterProductList) (19)
（13）二维码识别接口接口(dimensionsCodeItendify) (20)
（14）查询banner图片列表接口(queryBannerImageList) (21)
（15）查询banner活动商品列表接口(queryBannerActivityProductList) (22)
（16）查询来此购活动列表接口(letsGoActivity) (22)
（17）查询来此购活动详情接口(letsGoActivityDetail) (23)
（18）查询秒杀活动列表接口(spikeActivity) (24)
（19）查询秒杀活动详情接口(spikeActivityDetail) (25)
四、订单接口 (26)
（1）查询可用优惠券接口(queryUsableCoupon) (26)
（2）查询购物车接口(queryMemberCart) (27)
（3）添加/删除购物车接口(operateMemberCart) (29)
（4）编辑购物车接口(updateMemberCart) (30)
（5）购物车商品规格参数修改接口(updateMemberCartFormart) (30)
（6）一键领取优惠券接口(receiveSpecials) (31)
（7）购物车预结算接口(cartPresettlement) (32)
（8）订单预览接口(orderProview) (34)
（9）查询订单可适用优惠券列表接口(queryOrderSpecialsList) (36)
（10）提交订单接口(sumbitOrder) (37)
（11）创建缴费充值接口(createPayRechargeOrder) (39)
（12）创建轻松购订单接口(createEasyBuyOrder) (39)
（13）创建订单接口(createOrder) (40)
（14）获取可用支付渠道接口(getPaymentChannel) (41)
（15）订单支付接口(paymentOrder) (41)
（16）订单详情接口(detailOrder) (42)
（17）订单取消接口(cancleOrder) (43)
（18）订单删除接口(deleteOrder) (44)
五、会员信息接口 (45)
（1）查询会员信息接口(queryMemberInfo) (45)
（2）修改会员信息接口(updateMemberInfo) (46)
（3）查询会员可用积分接口(queryMemberUsablePoints) (46)
（4）查询会员积分接口(queryMemberPoints) (47)
（5）查询会员订单接口(queryMemberOrder) (48)
（6）售后处理－退货详情接口(returnsDetailOrder) (49)
（7）售后处理－退货订单查询接口(queryRefundOrder) (50)
（8）售后处理－退还货物接口(refundsGoods) (51)
（9）查询会员收藏接口(queryMemberIncome) (52)
（10）会员添加／取消收藏接口(memberOperateIncome) (53)
（11）会员批量添加收藏接口(memberAddBulkIncome) (54)
（12）查询会员优惠券接口(queryMemberCoupon) (54)
（13）会员投诉发送信息接口(sendComplaintMessage) (55)
（14）会员投诉获取信息接口(getComplaintMessage) (56)
（15）查询会员收货地址接口(queryMemberConsignee) (56)
（16）增加/修改会员收货地址接口(updateConsignee) (57)
（17）删除会员收货地址接口(deleteConsignee) (58)
（18）查询我的虚拟票券接口(queryMyVirtualTicket) (58)
（19）查询我的预约列表接口(queryMyReserveList) (59)
（20）查询我的轻松购接口(queryMyEasyPurchase) (60)
（21）查询我的轻松购(柜台详情)接口(queryMyEasyPurchaseMerchantDetail) .. 61（22）查询消息列表接口(queryMessageList) (62)
（23）查询消息详情接口(queryMessageDetail) (63)
（24）发送反馈问题接口(sendFeedbackProblems) (64)
（25）获取反馈问题回复接口(getFeedbackProblems) (65)
（26）查询我的e卡通接口(queryMyEcartoon) (65)
（27）修改e卡通密码接口(updateEcartoonPwd) (66)
（28）e卡通交易明细查询接口(eCartoonTcansactionDetail) (67)
（29）e卡通转账接口(eCartoonTransfers) (67)
（30）e卡通常用卡绑定接口(commonCartBinding) (68)
六、e卡通接口 (68)
（1）缴费充值－水电燃气接口(hydroGas) (69)
（2）缴费充值－宽带/固话(paymentKg) (70)
（3）缴费充值－手机账单接口/有线电视接口(phoneBill) (71)
七、预约柜台接口 (72)
（1）查询预约柜台列表接口(queryReserveCounterList) (72)
（2）查询预约柜台详情接口(queryReserveCounterDetail) (72)
（3）查询预约柜台座位接口(queryReserveCounterSeat) (73)
八、商场导航接口（二期） (74)
（1）获取当前位置接口(getCurrentPosition)（二期） (74)
（2）商家导航接口(merchantNavigation)（二期） (74)
九、分享接口 (75)
（1）查询分享渠道接口(queryReserveMerchantList) (75)
（2）查询预约商家详情接口(queryReserveMerchantDetail) (76)
（3）查询预约商家座位接口(queryReserveMerchantSeat) (76)
十、版本升级接口 (77)
（1）查询新版本接口(queryVersion) (77)
（2）下载新版本接口(downloadNewVersion) (78)
十一、附录 (91)
一、接口描述:
1.接口连接：https://https://www.wendangku.net/doc/e97441964.html,/api/接口名称
2.参数传递方式：POST方式
3.签名规则:sign字段采用MD5加密方式,sign的值是本次请求所有入参的key=value的叠
加通过&连接
4.返回格式json
5.编码格式utf8
6.所有入参与返回参数均首字母为小写，金额精确到分，时间14位，如20150213111900
7.响应请求状态码约定,成功响应为:200
8.对于非法请求如:”增加需带tokent的非法请求(未包含token或者token失效)”则响应
为:403
9.终端编码规则：
设备号|系统类型|操作系统版本号|安装时间戳
例如：设备号：android获取ios 生成uuid
系统类型 1 android 2 ios
操作系统版本号
安装时间戳20150106112008
10.接口描述
接口链接: https://www.wendangku.net/doc/e97441964.html,:10002/xjh_app-openapi/appapi/
参数传递方式: post
入参列表: body={"params":{"version":"1","pageNumber":"1","pageSize":"2"}}
返回格式: json
{"resData":{"result":"1","errorCode":"","errorMsg":""}}
result 为0成功 1失败
二、注册登录类接口
（1）手机快速注册接口(register)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/register
入参
body={"params":{"version":"","loginName":"","loginPwd":"","checkCode":"","termin alCode":""}}
传入变量
返回参数
注：注册后自动登录
（2）登陆接口(l ogin)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/login
入参
body={"params":{"version":"","loginName":"","loginPwd":"","terminalCode":""}}
传入变量
返回参数
（3）第三方账号登陆接口(thirdPartyLogin)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/thirdPartyLogin
入参
body={"params":{"version":"","thirdPartyType":"","thirdPartySign":"","thirdPartyNic k":"","imageUrl":"","thirdPartyToken":"","terminalCode":""}}
传入变量
（备注：第三方登录，新建用户账户／密码［暂定］，直接登录）
返回参数
（4）会员修改密码(updatePwd)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/updatePwd
入参
body={"params":{"version":"","userId":"","token":"","loginPwd":"","newPwd":""}} 传入变量
返回参数
（5）退出登陆(l ogout)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/logout
入参
body={"params":{"version":"","userId":"","token":""}}
传入变量
返回参数
三、商品接口
（1）查询商家接口(getMerchant)
提交Url:https://www. https://www.wendangku.net/doc/e97441964.html,/api/ getMerchant
入参
body={"params":{"version":"","positionInfo":"","searchType":"","terminalCode":""}} 传入变量
返回参数
备注：小商家不显示在首页
（2）查询商家下柜台列表接口(getMerchantCounterList)
提交Url: https://https://www.wendangku.net/doc/e97441964.html,/api/ getMerchantCounterList
入参
body={"params":{"version":"","merchantCode":"","pageSize":"","pageNumber":"","te rminalCode":""}}
传入变量
返回参数
（3）查询商品接口(getProduct)
提交Url: https://www. https://www.wendangku.net/doc/e97441964.html,/api/ getProduct
入参
body={"params":{"version":"","merchantCode":"","keywordsType":"","keywords":"", "filters":"","pageSize":"","pageNumber":"","terminalCode":""}}
传入变量
返回参数
（4）查询商品规格参数列表接口
(getProductSpecificationsList)
提交Url: https://www. https://www.wendangku.net/doc/e97441964.html,/api/ getProductSpecificationsList
入参
body={"params":{"version":"","merchantCode":"","productCode":"","terminalCode":" "}}
传入变量
返回参数
（5）查询品牌介绍接口(getBrandPresent)
提交Url: https://www. https://www.wendangku.net/doc/e97441964.html,/api/getBrandPresent
入参
body={"params":{"version":"","brandCode":"","merchantCode":"","productCode":"", "terminalCode":""}}
传入变量
返回参数
（6）查询商品介绍接口(getProductPresent)
提交Url: https://www. https://www.wendangku.net/doc/e97441964.html,/api/getProductPresent
入参
body={"params":{"version":"","brandCode":"","merchantCode":"","productCode":"", "terminalCode":""}}
传入变量
返回参数
（7）查询商品详情接口(getProductDetail)
提交Url: https://www. https://www.wendangku.net/doc/e97441964.html,/api/getProductDetail
入参
body={"params":{"version":"","token":"","userId":"","merchantCode":"","type":""," productCode":"","itemCode":"","terminalCode":"","formartInfoList":{"keyCode":""," valueCode":""}}}
传入变量
返回参数
（8）查询品牌分类列表接口(getBrandSortList)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/getBrandSortList
入参
body={"params":{"version":"","merchantCode":"","terminalCode":""}} 传入变量
返回参数
（9）查询品牌分类下属品牌列表接口
(getBrandByMerchantList)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/getBrandByMerchantList
入参
body={"params":{"version":"","merchantCode":"","brandName":"","brandSortCode": "","terminalCode":""}}
传入变量
返回参数
（10）查询品牌分类品牌归属柜台列表接口
(getBrandByCounterList)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/getBrandByCounterList
入参
body={"params":{"version":"","merchantCode":"","brandCode":"","terminalCode":"" }}
传入变量
返回参数
（11）查询品牌商家柜台详情接口
(getBrandMerchantCounterDetail)
提交Url:https://https://www.wendangku.net/doc/e97441964.html,/api/getBrandMerchantCounterDetail
入参
body={"params":{"version":"","merchantCode":"","counterCode":"","terminalCode":" "}}
传入变量
返回参数
（12）查询柜台下商品列表接口(getCounterProductList)
提交Url: https://www. https://www.wendangku.net/doc/e97441964.html,/api/getMerchantProductList
入参
body={"params":{"version":"","merchantCode":"","counterCode":"","terminalCode":" "}}
传入变量
返回参数