blackteay/ThinkAdmin
1
0
Fork 0
mirror of https://gitee.com/zoujingli/ThinkAdmin.git synced 2026-06-07 04:28:11 +08:00
Code Issues Projects Releases Wiki Activity
ThinkAdmin/plugin/think-plugs-payment/readme.api.md
Anyon e634118a22 refactor(plugin): 迁移 v8 插件化组件体系 
将 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 占位，保证安装发布流程可复现。
2026-05-08 15:30:46 +08:00

1.9 KiB
Raw Blame History

支付管理接口

接口标准

  • HTTP 入口：/api/payment/auth/{controller}/{action}
  • 所有接口都需要 Authorization: Bearer <JWT>
  • 返回格式为 JSON，继承账号授权接口返回结构
  • HTTP 状态码固定返回 200
  • code 统一使用常见业务状态语义：200 成功、401 未认证/登录过期、403 已认证但无权限、404 资源不存在、500 服务端异常
{
  "code": 200, // 业务状态码
  "info": "ok", // 提示信息
  "data": {}, // 业务数据
  "error": "", // 可选，401/403 等鉴权异常时返回稳定错误标识
  "token": "jwt" // 续签时可能返回，可选
}

接口列表

/api/payment/auth/address/set

  • 说明：新增或修改收货地址
{
  "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

  • 说明：获取当前用户地址列表
{}

/api/payment/auth/address/state

  • 说明：切换默认地址状态
{
  "id": 1, // 地址 ID
  "type": 1 // 目标状态，0 非默认，1 默认
}

/api/payment/auth/address/remove

  • 说明：删除收货地址
{
  "id": 1 // 地址 ID
}

/api/payment/auth/balance/get

  • 说明：分页获取余额记录
{
  "page": 1 // 页码
}

/api/payment/auth/integral/get

  • 说明：分页获取积分记录
{
  "page": 1 // 页码
}