aitori-bi-v2/doc/USER_POINTS_STATEMENT_API.md

用户积分流水 API 文档

本文档描述了用户积分流水相关的接口规范，整合了积分收入和支出记录。

1. 积分流水查询 (收入+支出)

• URL: /v2/user/points/record/statement
• Method: GET
• 描述: 分页查询用户的积分流水记录，统一展示积分的收入和支出情况。

请求参数

字段名	类型	必填	说明
page	integer	否	页码，默认 1
size	integer	否	每页大小，默认 10
userId	long	否	用户ID
type	integer	否	流水类型 1:收入 2:支出（不传则查全部）
startTime	string	否	开始时间 (yyyy-MM-dd HH:mm:ss)
endTime	string	否	结束时间 (yyyy-MM-dd HH:mm:ss)

响应参数 (data 字段)

返回 Mybatis-Plus Page 对象，包含 records (记录列表), total (总数), size (页大小), current (当前页) 等。

records 中的对象 (UserPointsStatementVO) 结构如下：

字段名	类型	说明
userId	long	用户ID
type	integer	流水类型 1:收入 2:支出
points	long	变动点数
title	string	标题/描述（仅支出记录有值，收入记录为 null，前端根据 businessType 自行展示）
businessType	integer	来源（仅收入记录）1:购买 2:兑换码 3:签到 4:分享 5:邀请 6:被邀请 7:邀请人使用模板 8:注册 9:投稿 10:评论 11:会员；支出记录为 null
createTime	string	创建时间
nickname	string	用户昵称
email	string	用户邮箱
appleUserId	string	苹果用户ID
originalTransactionId	string	原始交易ID
platform	string	平台
language	string	语言

示例请求

查询全部流水：

GET /v2/user/points/record/statement?page=1&size=10&userId=12345

仅查询收入：

GET /v2/user/points/record/statement?page=1&size=10&userId=12345&type=1

仅查询支出：

GET /v2/user/points/record/statement?page=1&size=10&userId=12345&type=2

示例响应

{
  "code": 200,
  "message": "success",
  "success": true,
  "data": {
    "records": [
      {
        "userId": 12345,
        "type": 1,
        "points": 100,
        "title": null,
        "businessType": 1,
        "createTime": "2023-10-27 10:00:00",
        "nickname": "User123",
        "email": "user@example.com",
        "appleUserId": "apple_123",
        "originalTransactionId": "txn_123",
        "platform": "IOS",
        "language": "zh-CN"
      },
      {
        "userId": 12345,
        "type": 2,
        "points": 50,
        "title": "购买道具",
        "businessType": null,
        "createTime": "2023-10-28 14:30:00",
        "nickname": "User123",
        "email": "user@example.com",
        "appleUserId": "apple_123",
        "originalTransactionId": "txn_123",
        "platform": "IOS",
        "language": "zh-CN"
      }
    ],
    "total": 2,
    "size": 10,
    "current": 1,
    "pages": 1
  },
  "timestamp": 1698372000000
}