soul-yongping/开发文档/4、前端/ui/04-API接口说明.md

API接口说明

接口列表

1. 配置接口

GET /api/config

获取系统配置信息

响应示例：

{
  "settings": {
    "distributorShare": 90,
    "authorShare": 10,
    "sectionPrice": 1,
    "baseBookPrice": 9.9,
    "paymentMethods": {...}
  }
}

---

2. 用户接口

POST /api/users/login

用户登录

请求参数：

参数	类型	必填	说明
phone	string	是	手机号
code	string	是	验证码

POST /api/users/register

用户注册

请求参数：

参数	类型	必填	说明
phone	string	是	手机号
nickname	string	是	昵称
referralCode	string	否	推荐码

GET /api/users

获取用户列表（管理端）

PUT /api/users/[id]

更新用户信息

---

3. 购买接口

POST /api/purchases

创建购买订单

请求参数：

参数	类型	必填	说明
type	string	是	购买类型：section/fullbook
sectionId	string	否	章节ID（单章购买时必填）
paymentMethod	string	是	支付方式：wechat
amount	number	是	金额

GET /api/purchases

获取购买记录

---

4. 提现接口

POST /api/withdrawals

申请提现

请求参数：

参数	类型	必填	说明
amount	number	是	提现金额
method	string	是	提现方式：wechat/alipay
account	string	是	收款账号
name	string	是	真实姓名

GET /api/withdrawals

获取提现记录

---

5. 分销接口

GET /api/distribution

获取分销数据

查询参数：

参数	类型	说明
type	string	查询类型：my-bindings/stats
userId	string	用户ID

---

6. 存客宝CKB接口

POST /api/ckb/join

加入类型申请（导师顾问/资源对接/团队招募）

请求参数：

参数	类型	必填	说明
type	string	是	类型：mentor/investor/team/partner
phone	string	否	手机号（二选一）
wechat	string	否	微信号（二选一）
userId	string	否	用户ID

POST /api/ckb/match

匹配行为上报

请求参数：

参数	类型	必填	说明
matchType	string	是	匹配类型
phone	string	否	手机号
wechat	string	否	微信号
matchedUser	object	否	匹配到的用户信息

---

7. 支付接口

POST /api/payment/create

创建支付订单

POST /api/payment/query

查询支付状态

---

8. 内容接口

GET /api/book/[sectionId]

获取章节内容

GET /api/book/sections

获取章节列表

---

接口流程图

购买流程

┌─────────┐     ┌─────────────┐     ┌─────────────┐
│  用户   │────▶│ 选择购买方式 │────▶│ 创建订单    │
└─────────┘     └─────────────┘     └──────┬──────┘
                                           │
                                           ▼
┌─────────┐     ┌─────────────┐     ┌─────────────┐
│ 完成购买 │◀────│ 轮询支付状态 │◀────│ 生成二维码  │
└─────────┘     └─────────────┘     └─────────────┘

分销绑定流程

┌─────────┐     ┌─────────────┐     ┌─────────────┐
│ 访客访问 │────▶│ 识别推荐码  │────▶│ 创建绑定关系 │
│ ?ref=xxx│     └─────────────┘     └──────┬──────┘
└─────────┘                                │
                                           ▼
┌─────────┐     ┌─────────────┐     ┌─────────────┐
│ 分成计算 │◀────│ 访客购买    │◀────│ 30天绑定期  │
│ 推广者90%│     └─────────────┘     └─────────────┘
└─────────┘

---

文档版本：v2.0 | 更新日期：2026-01-18