完整的后端接口文档 | 50+ 核心 API | 实时更新
账号密码方式登录，返回 JWT Token
| 参数 | 类型 | 描述 |
|---|---|---|
| username | String | 用户名 |
| password | String | 密码（MD5加密） |
{
"username": "admin",
"password": "123456"
}
短信验证码方式登录
| 参数 | 类型 | 描述 |
|---|---|---|
| phone | String | 手机号 |
| smsCode | String | 短信验证码 |
发送短信验证码
| 参数 | 类型 | 描述 |
|---|---|---|
| phone | String | 目标手机号 |
支持树形结构，支持多级区域
支持地理位置查询，支持收藏功能
支持状态管理、数据同步
支持实时数据更新、远程停止
创建充电订单，开始计费
| 参数 | 类型 | 描述 |
|---|---|---|
| gunId | Long | 充电枪ID |
| userId | Long | 用户ID |
| paymentMethod | String | 支付方式 |
停止充电，结束计费，返回费用
| 参数 | 类型 | 描述 |
|---|---|---|
| orderId | Long | 订单ID |
查询订单列表，支持状态筛选和分页
| 参数 | 类型 | 描述 |
|---|---|---|
| status | String | 订单状态（charging/completed/failed） |
| pageNo | Integer | 页码 |
| pageSize | Integer | 每页数量 |
返回总充电笔数、总充电度数、总收益、在线设备数等统计数据
返回最近30天的营收趋势数据，用于图表展示
返回TOP10收益最高的站点排行
返回设备离线、充电异常等告警信息
返回设备在线、离线、故障等状态分布
支持启用/禁用分账配置
支持结算单的查询、确认、打款操作
执行银行对账，返回对账结果
微信授权登录
| 参数 | 类型 | 描述 |
|---|---|---|
| code | String | 微信授权code |
返回首页站点列表和用户信息
基于用户位置查询附近站点
| 参数 | 类型 | 描述 |
|---|---|---|
| lat | Double | 纬度 |
| lng | Double | 经度 |
| distance | Integer | 查询距离（米） |
小程序开始充电
| 参数 | 类型 | 描述 |
|---|---|---|
| gunId | Long | 充电枪ID |
查询用户订单列表
| 参数 | 类型 | 描述 |
|---|---|---|
| status | String | 订单状态（可选） |
| pageNo | Integer | 页码 |
{
"code": 0,
"message": "success",
"data": {
// 业务数据
}
}
{
"code": 400,
"message": "错误信息描述",
"data": null
}
| 错误码 | 描述 |
|---|---|
| 0 | 成功 |
| 400 | 请求参数错误 |
| 401 | 未授权（Token过期或无效） |
| 403 | 禁止访问（无权限） |
| 404 | 资源不存在 |
| 500 | 服务器内部错误 |
所有API（除了登录接口外）都需要在请求头中携带 JWT Token：
Authorization: Bearer {token}
详细的API参数、返回值、错误处理等完整文档会在源代码的 Javadoc 注释中，
也可以使用 Swagger 在线文档查看：
http://localhost:8080/swagger-ui.html