模块说明
vip 提供 VIP 会员卡体系:套餐列表(含价格与权益字段配置)、购买成功页、会员 VIP 购买记录。
鉴权级别:套餐列表与成功页公开;购买记录必须登录。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/vip |
公开 | VIP 套餐列表 |
| GET | /api/vip/success |
公开 | 购买成功页 |
| GET | /api/user/vip |
必须 | 我的 VIP 购买记录 |
VIP 套餐列表 GET /api/vip
{
"code": "OK",
"message": "",
"data": {
"title": "VIP会员",
"package_list": [ { "id": 1, "name": "年卡", "money": "...", "...": "" } ],
"content_field": [ "权益字段1", "权益字段2" ]
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
content_field为站点配置的套餐权益字段清单(逗号分隔配置项拆分为数组),客户端可据此渲染权益对比表。
购买成功页 GET /api/vip/success
{
"code": "OK",
"message": "",
"data": { "title": "VIP会员" },
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
我的 VIP 记录 GET /api/user/vip
| 参数 | 必填 | 说明 |
|---|---|---|
page |
否 | 页码,默认 1 |
{
"code": "OK",
"message": "",
"data": {
"title": "VIP记录",
"log_list": [ { "id": 1, "package": "...", "add_time": "...", "...": "" } ],
"pager": { "...": "分页信息" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- VIP 购买走支付链路(收银台支付),支付成功页可跳转
GET /api/vip/success; - 套餐价格字段为格式化字符串或数值由站点数据决定,以实际返回为准。