[关闭]
@xuduochoua 2017-11-09T09:30:40.000000Z 字数 3420 阅读 1388

云电桩微信接口

winsky

返回JSON格式说明

  1. {
  2. code:0,//返回码 0-默认 成功
  3. msg:"",//错误码说明信息
  4. data:null//接口需求的具体数据 或List 或String 等
  5. }

接口说明

base_url:http(s)://ip:port/projectName/api/

1.获取短信验证码

接口地址:
POST /auth/smscode

eg. https://www.wechat.winsky.com/auth/smscode?mobile=15011112222

请求参数:

参数 数据类型 必填 参数说明
mobile string Y 接收短信的手机号码

错误码说明

code 错误原因 返回消息
502 与短信接口通讯异常 短信验证码发送失败

响应结果:

  1. {
  2. "code": 0, //0 - 接口调用成功,其他值表示失败
  3. "message": "",
  4. "data": null
  5. }

2.用户登录

POST /anth/login
请求参数:

参数 数据类型 必填 参数说明
mobile String Y 手机号
smscode String Y 验证码

运行时异常

code 错误原因 返回消息
9999 xxx xxx

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. id12//用户id
  6. nickname:"",//昵称
  7. portrait:"",//头像
  8. mobile:"",//绑定手机号
  9. gender:0//性别
  10. }
  11. }

3.退出户登录

POST /anth/logout
请求参数:

参数 数据类型 必填 参数说明
mobile String Y 手机号

运行时异常

code 错误原因 返回消息
9999 xxx xxx

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

4.附近充电站

POST /charge/stations

eg. https://www.wechat.winsky.com/charge/station

请求参数:

参数 数据类型 必填 参数说明
longitude Double Y 经度
latitude Double Y 纬度
type int N 0-默认 附近充电站 1-最近使用
page int N 页码 默认1
size int N 页面数量 默认5

运行时异常

code 错误原因 返回消息
888 xxx xxx

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. id:123,
  7. type:2,//1-云杉 2-第三方
  8. name:"科技充电站",
  9. status:0,//0-空闲
  10. addr:"北京市朝阳区",
  11. 快充:20
  12. 慢充:10
  13. total:70,
  14. 电费:1.2
  15. distance:9555,
  16. distanceStr:"9公里"
  17. },{
  18. ...
  19. }
  20. ]
  21. }

5.充电站详情

POST /charge/station/{id}
路径参数:
id:电站id

运行时异常

code 错误原因 返回消息
9999 xxx xxx

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. id:123,
  7. type:2,//1-云杉 2-第三方
  8. name:"科技充电站",
  9. status:0,//0-空闲
  10. addr:"北京市朝阳区",
  11. 快充:20
  12. 慢充:10
  13. total:70,
  14. distance:9555,
  15. 电费:1.2,
  16. 服务费:0.1,
  17. 停车费:"工作日:8:00-20:00,第一小时5元..."
  18. 峰平谷计费:Object
  19. },{
  20. ...
  21. }
  22. ]
  23. }

6.充电站桩列表

POST /charge/station/{id}/stakes
路径参数:
id:电站id
请求参数:

参数 数据类型 必填 参数说明
type int N 0 默认-空现桩 ,1-其他桩
page int N 页码 默认1
size int N 页面数量 默认5

运行时异常

code 错误原因 返回消息
9999 xxx xxx

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[
  5. {
  6. id:123,
  7. 桩号:"",//装
  8. 编号:"科技充电站",
  9. type:0,//快慢充
  10. power:7,//7KW
  11. status0// 空闲:充电中:不可用:
  12. gunNum:8//桩枪数
  13. },{
  14. ...
  15. }
  16. ]
  17. }

查询是否有充电中订单

POST /charge/incharged
请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息
401 未登录 请先登录

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:true
  5. }

8.开始充电

POST /charge/incharged
请求参数:

参数 数据类型 必填 参数说明
groupId String Y 桩群id
stackeId String Y 桩id
... ... ... 其他数据待定

运行时异常

code 错误原因 返回消息
401 未登录 请先登录
888 ... ...

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:Object// 生成的订单
  5. }

9.结束充电

POST /charge/finish
请求参数:
|参数|数据类型|必填|参数说明|
|-|-|-|
orderno|String|Y|订单号
运行时异常

code 错误原因 返回消息
401 未登录 请先登录

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:null
  5. }

10.订单详情

POST /charge/order/{orderno}
路径参数:
orderno订单号

运行时异常

code 错误原因 返回消息
401 未登录 请先登录

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. orderno:"123456",
  6. 充电站:"电子科技大厦",
  7. 桩号:"01",
  8. 抢号:"03",
  9. 开始充电时间:""
  10. 结束充电时间:"",
  11. 充电时长:""
  12. 充电度数:25.5,
  13. 应付金额:256,
  14. 电费:123.5,
  15. 服务费:15.6,
  16. 实付金额:240.6
  17. }
  18. }

13编辑个人信息

POST /anth/login
请求参数:

参数 数据类型 必填 参数说明
nickname String Y 昵称
gender int N 性别

运行时异常

code 错误原因 返回消息
401 xxx xxx

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. id12//用户id
  6. nickname:"",//昵称
  7. portrait:"",//头像
  8. mobile:"",//绑定手机号
  9. gender:0//性别
  10. }
  11. }

14.充电记录列表

POST /charge/orders

运行时异常

code 错误原因 返回消息
401 未登录 请先登录

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. orderno:"123456",
  6. 充电站:"电子科技大厦",
  7. 桩号:"01",
  8. 抢号:"03",
  9. 开始充电时间:""
  10. 结束充电时间:"",
  11. 充电时长:""
  12. 充电度数:25.5,
  13. 应付金额:256,
  14. 电费:123.5,
  15. 服务费:15.6,
  16. 实付金额:240.6
  17. },...
  18. ]
  19. }

1x.用户余额

POST /anth/balance
请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息
401 未登录 请先登录

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:525.5
  5. }

15.账户余额明细列表

POST /anth/balance
请求参数:

参数 数据类型 必填 参数说明

运行时异常

code 错误原因 返回消息
401 未登录 请先登录

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:[{
  5. id:,
  6. type:0,
  7. time:"",
  8. amount:100,
  9. },
  10. ...
  11. ]
  12. }

17.获得微信config参数

GET /wechat/config
请求参数:

参数 数据类型 必填 参数说明
url String Y 当前url ,签名需要

运行时异常

code 错误原因 返回消息
401 未登录 请先登录

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. appId:"",
  6. timestamp:"",
  7. nonceStr:"",
  8. signature:"",
  9. jsApiList:[]
  10. }
  11. }

18.统一下单

GET /wechat/uniordermap
请求参数:

参数 数据类型 必填 参数说明
ip String Y ip
money float Y 金额

运行时异常

code 错误原因 返回消息
9999 xxx xxx

响应结果:

  1. {
  2. code:0,
  3. msg:"",
  4. data:{
  5. appId:"",
  6. timestamp:"",
  7. nonceStr:"",
  8. signature:"",
  9. jsApiList:[],
  10. ....
  11. }
  12. }

支付成功回调接口

GET /wechat/notify

用于充值成功的回调,需直接能访问

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注