小程序商城对接APP应用服务器的接口说明
目录
说明: 2
1、 用户登录商城 2
2、 获取用户积分 4
3、 修改用户积分 5
4、 申请积分兑换 6
5、 修改用户信息 7
6、 获取充值比例 9
7、 获取兑换记录列表 10
8、 获取充值记录列表 13
说明:
接口请求协议https;
请求域名如www.youjiaapp.com;
端口测试使用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;//中奖积分
}