mirror of
https://gitee.com/zoujingli/ThinkAdmin.git
synced 2026-06-07 20:48:09 +08:00
e634118a22
将 v6 中直接放在本地 app 的后台与微信能力迁移为 v8 插件组件，并把运行时基础能力沉淀到独立插件包。 主要内容： - 新增 think-library、system、worker、static、install 等基础插件包。 - 新增 account、payment、wechat-client、wechat-service、wemall、wuma 等业务插件包。 - 移除 v6 的 app/admin 与 app/wechat 本地应用实现，改由插件分发接管。 - 将 Helper 能力彻底并入 System，统一为 plugin\system\helper\* 命名空间。 - 同步插件迁移发布清单与根 route 占位，保证安装发布流程可复现。
84 lines
1.9 KiB
Markdown
84 lines
1.9 KiB
Markdown
# 支付管理接口
|
||
|
||
## 接口标准
|
||
- HTTP 入口：`/api/payment/auth/{controller}/{action}`
|
||
- 所有接口都需要 `Authorization: Bearer <JWT>`
|
||
- 返回格式为 JSON，继承账号授权接口返回结构
|
||
- HTTP 状态码固定返回 `200`
|
||
- `code` 统一使用常见业务状态语义：`200` 成功、`401` 未认证/登录过期、`403` 已认证但无权限、`404` 资源不存在、`500` 服务端异常
|
||
|
||
```jsonc
|
||
{
|
||
"code": 200, // 业务状态码
|
||
"info": "ok", // 提示信息
|
||
"data": {}, // 业务数据
|
||
"error": "", // 可选，401/403 等鉴权异常时返回稳定错误标识
|
||
"token": "jwt" // 续签时可能返回，可选
|
||
}
|
||
```
|
||
|
||
## 接口列表
|
||
|
||
### `/api/payment/auth/address/set`
|
||
- 说明：新增或修改收货地址
|
||
|
||
```jsonc
|
||
{
|
||
"id": 0, // 地址 ID，0 表示新增，非 0 表示更新
|
||
"type": 1, // 默认地址标记，0 否，1 是
|
||
"user_name": "张三", // 收货人姓名
|
||
"user_phone": "13800000000", // 收货人手机号
|
||
"region_prov": "浙江省", // 省份
|
||
"region_city": "杭州市", // 城市
|
||
"region_area": "西湖区", // 区县
|
||
"region_addr": "文三路 1 号", // 详细地址
|
||
"idcode": "", // 可选，身份证号码
|
||
"idimg1": "", // 可选，身份证正面图片
|
||
"idimg2": "" // 可选，身份证反面图片
|
||
}
|
||
```
|
||
|
||
### `/api/payment/auth/address/get`
|
||
- 说明：获取当前用户地址列表
|
||
|
||
```jsonc
|
||
{}
|
||
```
|
||
|
||
### `/api/payment/auth/address/state`
|
||
- 说明：切换默认地址状态
|
||
|
||
```jsonc
|
||
{
|
||
"id": 1, // 地址 ID
|
||
"type": 1 // 目标状态，0 非默认，1 默认
|
||
}
|
||
```
|
||
|
||
### `/api/payment/auth/address/remove`
|
||
- 说明：删除收货地址
|
||
|
||
```jsonc
|
||
{
|
||
"id": 1 // 地址 ID
|
||
}
|
||
```
|
||
|
||
### `/api/payment/auth/balance/get`
|
||
- 说明：分页获取余额记录
|
||
|
||
```jsonc
|
||
{
|
||
"page": 1 // 页码
|
||
}
|
||
```
|
||
|
||
### `/api/payment/auth/integral/get`
|
||
- 说明：分页获取积分记录
|
||
|
||
```jsonc
|
||
{
|
||
"page": 1 // 页码
|
||
}
|
||
```
|