@xuduochoua
2017-11-09T09:30:40.000000Z
字数 3420
阅读 1388
winsky
{code:0,//返回码 0-默认 成功msg:"",//错误码说明信息data:null//接口需求的具体数据 或List 或String 等}
base_url:http(s)://ip:port/projectName/api/
接口地址:
POST /auth/smscode
eg. https://www.wechat.winsky.com/auth/smscode?mobile=15011112222
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| mobile | string | Y | 接收短信的手机号码 |
错误码说明
| code | 错误原因 | 返回消息 |
|---|---|---|
| 502 | 与短信接口通讯异常 | 短信验证码发送失败 |
响应结果:
{"code": 0, //0 - 接口调用成功,其他值表示失败"message": "","data": null}
POST /anth/login
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| mobile | String | Y | 手机号 |
| smscode | String | Y | 验证码 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 9999 | xxx | xxx |
响应结果:
{code:0,msg:"",data:{id:12,//用户idnickname:"",//昵称portrait:"",//头像mobile:"",//绑定手机号gender:0//性别}}
POST /anth/logout
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| mobile | String | Y | 手机号 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 9999 | xxx | xxx |
响应结果:
{code:0,msg:"",data:null}
POST /charge/stations
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| longitude | Double | Y | 经度 |
| latitude | Double | Y | 纬度 |
| type | int | N | 0-默认 附近充电站 1-最近使用 |
| page | int | N | 页码 默认1 |
| size | int | N | 页面数量 默认5 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 888 | xxx | xxx |
响应结果:
{code:0,msg:"",data:[{id:123,type:2,//1-云杉 2-第三方name:"科技充电站",status:0,//0-空闲addr:"北京市朝阳区",快充:20,慢充:10,total:70,电费:1.2distance:9555,distanceStr:"9公里"},{...}]}
POST /charge/station/{id}
路径参数:
id:电站id
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 9999 | xxx | xxx |
响应结果:
{code:0,msg:"",data:[{id:123,type:2,//1-云杉 2-第三方name:"科技充电站",status:0,//0-空闲addr:"北京市朝阳区",快充:20,慢充:10,total:70,distance:9555,电费:1.2,服务费:0.1,停车费:"工作日:8:00-20:00,第一小时5元...",峰平谷计费:Object},{...}]}
POST /charge/station/{id}/stakes
路径参数:
id:电站id
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| type | int | N | 0 默认-空现桩 ,1-其他桩 |
| page | int | N | 页码 默认1 |
| size | int | N | 页面数量 默认5 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 9999 | xxx | xxx |
响应结果:
{code:0,msg:"",data:[{id:123,桩号:"",//装编号:"科技充电站",type:0,//快慢充power:7,//7KWstatus:0// 空闲:充电中:不可用:gunNum:8//桩枪数},{...}]}
POST /charge/incharged
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | 未登录 | 请先登录 |
响应结果:
{code:0,msg:"",data:true}
POST /charge/incharged
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| groupId | String | Y | 桩群id |
| stackeId | String | Y | 桩id |
| ... | ... | ... | 其他数据待定 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | 未登录 | 请先登录 |
| 888 | ... | ... |
响应结果:
{code:0,msg:"",data:Object// 生成的订单}
POST /charge/finish
请求参数:
|参数|数据类型|必填|参数说明|
|-|-|-|
orderno|String|Y|订单号
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | 未登录 | 请先登录 |
响应结果:
{code:0,msg:"",data:null}
POST /charge/order/{orderno}
路径参数:
orderno:订单号
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | 未登录 | 请先登录 |
响应结果:
{code:0,msg:"",data:{orderno:"123456",充电站:"电子科技大厦",桩号:"01",抢号:"03",开始充电时间:"",结束充电时间:"",充电时长:"",充电度数:25.5,应付金额:256,电费:123.5,服务费:15.6,实付金额:240.6}}
POST /anth/login
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| nickname | String | Y | 昵称 |
| gender | int | N | 性别 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | xxx | xxx |
响应结果:
{code:0,msg:"",data:{id:12,//用户idnickname:"",//昵称portrait:"",//头像mobile:"",//绑定手机号gender:0//性别}}
POST /charge/orders
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | 未登录 | 请先登录 |
响应结果:
{code:0,msg:"",data:[{orderno:"123456",充电站:"电子科技大厦",桩号:"01",抢号:"03",开始充电时间:"",结束充电时间:"",充电时长:"",充电度数:25.5,应付金额:256,电费:123.5,服务费:15.6,实付金额:240.6},...]}
POST /anth/balance
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | 未登录 | 请先登录 |
响应结果:
{code:0,msg:"",data:525.5}
POST /anth/balance
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | 未登录 | 请先登录 |
响应结果:
{code:0,msg:"",data:[{id:,type:0,time:"",amount:100,},...]}
GET /wechat/config
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| url | String | Y | 当前url ,签名需要 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 401 | 未登录 | 请先登录 |
响应结果:
{code:0,msg:"",data:{appId:"",timestamp:"",nonceStr:"",signature:"",jsApiList:[]}}
GET /wechat/uniordermap
请求参数:
| 参数 | 数据类型 | 必填 | 参数说明 |
|---|---|---|---|
| ip | String | Y | ip |
| money | float | Y | 金额 |
运行时异常
| code | 错误原因 | 返回消息 |
|---|---|---|
| 9999 | xxx | xxx |
响应结果:
{code:0,msg:"",data:{appId:"",timestamp:"",nonceStr:"",signature:"",jsApiList:[],....}}
GET /wechat/notify
用于充值成功的回调,需直接能访问