oe沐鸣_小程序商城对接APP应用服务器的接口说明
目录
说明： 2
1、 用户登录商城 2
2、 获取用户积分 4
3、 修改用户积分 5
4、 申请积分兑换 6
5、 修改用户信息 7
6、 获取充值比例 9
7、 获取兑换记录列表 10
8、 获取充值记录列表 13
说明：
接口请求协议https；
请求域名如www.szfangwei.cn；
端口测试使用8080，正式版使用80
请求参数唯一，用param，param为请求对象转成json字符串；
请求返回用同一个的对象Result，参数说明如下；
参数名
参数类型
参数示例
参数说明
actioncode
字符串
SUCCESS
用于判断请求是否成功（SUCCESS为成功）
data
字符串
{
“ssid”:”swdurj5ifjti65jucf11”,
“tokenuuid”:
“b5c5891a8a8042ae801d42ff2f6efe6d”
}
请求成功后获取的数据对象以json字符串的形式赋值给data
endtime
字符串
最后响应时间
message
字符串
请求的说明
用户登录商城
接口地址
https://ip:8080/outsideaction/wxMallAction/doLogin
接口说明
用户登录商城验证 返回用户数据
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“loginname”:”admin”,
“password”:”123″,
“openid”:”123″,
“appid”:”123″
}
https://IP:8080/outsideaction/wxMallAction/doLogin?param={“loginname”:”admin”,”password”:”123″,”openid”:”123″,”appid”:”123″}
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:
{“ssid”:”swdurj5ifjti65jucf11”,
“nickname”:”admin”,
“integraltotal”:100,
“integralexchangeed”:100,
“integralexchange”:100},
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”用户名或密码错误”,”token”:”true”}
实际返回的数据说明
ssid;//用户ssid
integraltotal;//总积分
integralexchangeed; //已兑换积分
integralexchange; //可兑换积分
nickname;//昵称
获取用户积分
接口地址
https://ip:8080/outsideaction/wxMallAction/getUserIntegral
接口说明
获取用户积分
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“tokenuuid”:”b1345891a8a80fse801d42ff2f6136d”
}
https://IP:8080/outsideaction/wxMallAction/doLogin?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”}
Userssid用户的唯一标识
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:
{
“integraltotal”:100,
“integralexchangeed”:100,
“integralexchange”:100
},
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”用户名或密码错误”,”token”:”true”}
实际返回的数据说明
integraltotal;//总积分
integralexchangeed; //已兑换积分
integralexchange; //可兑换积分
修改用户积分
接口地址
https://ip:8080/outsideaction/wxMallAction/updateUserIntegral
接口说明
修改用户积分
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“tokenuuid”:”b1345891a8a80fse801d42ff2f6136d”,
“integeraltype”:1,
“score”:1000
}
https://IP:8080/outsideaction/wxMallAction/getUserIntegral?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“integeraltype”:1,
“score”:1000}
参数说明
integeraltype;//积分兑换RMB==1，充值积分==2， 中奖添加积分==3
score;//充值/兑换/中奖的积分
userssid;//用户的唯一标识
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:
{
“integraltotal”:100,
“integralexchangeed”:100,
“integralexchange”:100
},
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”用户名或密码错误”,”token”:”true”}
实际返回的数据说明
integraltotal;//总积分
integralexchangeed; //已兑换积分
integralexchange; //可兑换积分
申请积分兑换
接口地址
https://ip:8080/outsideaction/wxMallAction/integralExchange
接口说明
申请积分兑换
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“exchangeid”:”123456″,
“exchangescore”:12000,
“exchangetype”:2
}
https://IP:8080/outsideaction/wxMallAction/integralExchange?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“exchangeid”:”123456″,
“exchangescore”:12000,
“exchangetype”:2}
exchangeid;//兑换、中奖物品时的物品id，字符串格式
exchangescore;// 兑换积分
exchangetype;// 1/兑换现金 2/实物 3/抽奖
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:null,
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”用户名或密码错误”,”token”:”true”}
实际返回的数据说明
data里面可以不要数据，根据actioncode判断是否修改成功
修改用户信息
接口地址
https://ip:8080/outsideaction/wxMallAction/updateUserinfo
接口说明
修改用户信息（主要是改手机、微信、收货地址）
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“phonenum”:”12512451368″,
“wechatid”:”wx125124513″,
“email”:”12512@qq.com”,
“address”:”深圳市宝安区196号 XX收”
}
https://IP:8080/outsideaction/wxMallAction/doLogin?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“phonenum”:”12512451368″,
“wechatid”:”wx125124513″,
“email”:”12512@qq.com”,
“address”:”深圳市宝安区196号 XX收”
}
phonenum;//手机号
wechatid;//微信号
email;//邮箱
address;//收货地址
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:null,
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”用户名或密码错误”,”token”:”true”}
实际返回的数据说明
data里面可以不要数据，根据actioncode判断是否修改成功
获取充值比例
接口地址
https://ip:8080/outsideaction/wxMallAction/getRechargePercent
接口说明
获取充值比例
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”
}
https://IP:8080/outsideaction/wxMallAction/doLogin?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”}
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:
{“currencytype”:”rmb”,
“score”:10000
},
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”用户名或密码错误”,”token”:”true”}
实际返回的数据说明
currencytype=”rmb”;//rmb标识人民币
score=100;//1单位的货币兑换可以的积分
获取兑换记录列表
接口地址
https://ip:8080/outsideaction/wxMallAction/getExchangeList
接口说明
获取兑换记录列表
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“pageSize”:10,
“currPage”:1
}
https://IP:8080/outsideaction/wxMallAction/doLogin?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“pageSize”:10,
“currPage”:”1″}
pageSize;//每页条数
currPage;//当前页码 要查询的页码
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:
{
“exchangeAllScore”:2000,
“exchangeMoneyScore”:1000,
“exchangeMoneyTotal”:1,
“exchangeGoodsScore”:1000,
“maxPage”:5,
“currPage”:1,
“maxSize”:48,
“exchangeList”:[
{
“applyscore”:10000,
“usemoney”:100,
“exchangetype”:1,
“applystate”:1,
“applynum”:1,
“appphysicalid”:””,
“wantExchargetime”:”2015-12-12 12:12:12”
}
{
“applyscore”:10000,
“usemoney”:100,
“exchangetype”:1,
“applystate”:1,
“applynum”:1,
“appphysicalid”:””,
“wantExchargetime”:”2015-12-12 12:12:12”
}
{…}
]
},
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”暂无兑换记录”,”token”:”true”}
实际返回的数据说明
exchangeAllScore;//兑换总积分
exchangeMoneyScore;//兑换现金的积分
exchangeGoodsScore;//兑换实物的积分
exchangeMoneyTotal;//兑换现金的金额
maxPage;//总页数
currPage;//当前页码
maxSize;//总条数
exchangeList:{//兑换列表
applyscore;//兑换的积分
usemoney;//兑换的金额
applystate;//兑换的状态 1兑换中，2兑换成功，-1兑换失败
exchangetype;//兑换的类型 ，兑换金额==1，兑换物品==2
applynum;//兑换的个数
appphysicalid;//兑换商品的id标识
wantExchargetime;//兑换的申请时间
}
获取充值记录列表
接口地址
https://ip:8080/outsideaction/wxMallAction/getRechargeList
接口说明
获取兑换记录列表
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“pageSize”:10,
“currPage”:1
}
https://IP:8080/outsideaction/wxMallAction/getRechargeList?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“pageSize”:10,
“currPage”:”1″}
pageSize;//每页条数
currPage;//当前页码 要查询的页码
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:
{
“rechargeAllScore”:2000,
“rechargeMoneyTotal”:1000,
“maxPage”:5,
“currPage”:1,
“maxSize”:48,
“rechargeList”:[
{
“usemoney”:1,
“rechargescore”:1000,
“addtime”:”2015-12-12 12:12:12”
},
{
“usemoney”:2,
“rechargescore”:2000,
“addtime”:”2015-12-12 12:12:12”
},{…}
]
},
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”暂无充值记录”,”token”:”true”}
实际返回的数据说明
rechargeAllScore;//充值总积分
rechargeMoneyTotal;//充值总金额
maxPage;//总页数
currPage;//当前页码
maxSize;//总条数
rechargeList:{//充值记录列表
rechargescore;//充值的积分
usemoney;//充值的金额
addtime;//充值时间
}
1、接口1==》说明：新增字段【luckscore】
抽奖操作时若中了积分传递积分值luckscore；中了实物则传递实物exchangeid
接口地址
https://ip:8080/outsideaction/wxMallAction/integralExchange
接口说明
申请积分兑换
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“exchangeid”:”123456″,
“exchangescore”:12000,
“exchangetype”:2,
“luckscore”:1000
}
https://192.168.3.93:8080/outsideaction/wxMallAction/integralExchange?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“exchangeid”:”123456″,
“exchangescore”:12000,
“exchangetype”:2,
“luckscore”:1000
}
exchangeid;//兑换物品时的物品id，字符串格式
exchangescore;// 兑换积分
exchangetype;// 1/兑换现金 2/实物，3/抽奖
Luckscore;//中奖积分
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:null,
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”用户名或密码错误”,”token”:”true”}
实际返回的数据说明
data里面可以不要数据，根据actioncode判断是否修改成功
接口2==》说明：抽奖查询中奖积分字段【luckscore】
接口地址
https://ip:8080/outsideaction/wxMallAction/getExchangeList
接口说明
获取兑换记录列表
输入参数
参数
类型
默认值
说明
param
String
请求唯一参数，它是有多个参数的对象封装成json字符串的形式存在
param= {
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“pageSize”:10,
“currPage”:1
}
https://192.168.3.93:8080/outsideaction/wxMallAction/doLogin?param={
“userssid”:”b5c5891a8a8042ae801d42ff2f6efe6d”,
“pageSize”:10,
“currPage”:”1″}
pageSize;//每页条数
currPage;//当前页码 要查询的页码
输出结果 :
类型
返回json数据
成功返回
{
“version”:”V1.X”,
“actioncode”:”SUCCESS”,
“data”:
{
“exchangeAllScore”:2000,
“exchangeMoneyScore”:1000,
“exchangeMoneyTotal”:1,
“exchangeGoodsScore”:1000,
“maxPage”:5,
“currPage”:1,
“maxSize”:48,
“exchangeList”:[
{
“applyscore”:10000,
“usemoney”:100,
“exchangetype”:1,
“applystate”:1,
“applynum”:1,
“appphysicalid”:””,
“wantExchargetime”:”2015-12-12 12:12:12”,
“luckscore”: 1000
}
{
“applyscore”:10000,
“usemoney”:100,
“exchangetype”:1,
“applystate”:1,
“applynum”:1,
“appphysicalid”:””,
“wantExchargetime”:”2015-12-12 12:12:12”,
“luckscore”: 1000
}
{…}
]
},
“endtime”:”2018-12-11 11:33:02″,
“message”:”请求成功”,”token”:”true”
}
失败返回
{“version”:”V1.X”,
“actioncode”:”FAIL”,
“data”:””,
“endtime”:”2018-12-11 11:35:25″,
“message”:”用户名或密码错误”,”token”:”true”}
实际返回的数据说明
exchangeAllScore;//兑换总积分
exchangeMoneyScore;//兑换现金的积分
exchangeGoodsScore;//兑换实物的积分
exchangeMoneyTotal;//兑换现金的金额
maxPage;//总页数
currPage;//当前页码
maxSize;//总条数
exchangeList:{//兑换列表
applyscore;//兑换的积分
usemoney;//兑换的金额
applystate;//兑换的状态 0兑换中，1兑换成功，-1兑换失败
exchangetype;//兑换的类型 ，兑换金额==1，兑换物品==2 ，抽奖==3
applynum;//兑换的个数
appphysicalid;//兑换商品的id标识
wantExchargetime;//兑换的申请时间
Luckscore；//中奖积分
}