加载中…
积分 point

模块说明

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 数据结构,差异在于积分字段。
添加日期:2026-10-06