模块说明
point 提供积分体系接口:积分商城(可用积分兑换的商品列表)与会员积分明细(流水与总积分)。
鉴权级别:积分商城公开(未登录即可浏览);积分明细必须登录。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/point |
公开 | 积分商城商品列表 |
| GET | /api/user/point |
必须 | 我的积分明细 |
积分商城 GET /api/point
| 参数 | 必填 | 说明 |
|---|---|---|
page |
否 | 页码,默认 1 |
{
"code": "OK",
"message": "",
"data": {
"title": "积分商城",
"product_list": [
{ "id": 12, "name": "...", "point": "...", "url": "pages/product/show?id=12&mode=point" }
],
"pager": { "...": "分页信息" },
"total": 8
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
列表项
url为小程序形态跳转地址(含&mode=point参数,标识积分兑换模式),通用客户端请按自身路由规则跳转。
我的积分明细 GET /api/user/point
| 参数 | 必填 | 说明 |
|---|---|---|
page |
否 | 页码,默认 1 |
{
"code": "OK",
"message": "",
"data": {
"title": "积分明细",
"log_list": [ { "id": 1, "point": "...", "add_time": "...", "...": "" } ],
"total": 100,
"pager": { "...": "分页信息" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
total为当前会员总积分(非分页记录数);log_list为积分流水。
注意事项
- 积分兑换下单走订单模块的
mode=point形态(购物车加购mode=point),积分不足等业务错误由订单/积分服务返回; - 积分商城商品与普通商品共用
product数据结构,差异在于积分字段。