aitori-bi-v2/doc/USER_POINTS_RECORD_API.md

用户积分记录 API 文档

本文档描述了用户积分变更记录相关的接口规范。

1. 积分变动记录查询

• URL: /v2/user/points/record/list
• Method: GET
• 描述: 分页查询用户的积分变动记录，包含变动详情及关联的用户基础信息。

请求参数

字段名	类型	必填	说明
page	integer	否	页码，默认 1
size	integer	否	每页大小，默认 10
userId	long	否	用户ID
source	integer	否	来源 1:购买 2:兑换码 3:签到 4:分享 5:邀请 6:被邀请 7:邀请人使用模板 8:注册 9:投稿 10:评论 11:会员
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 中的对象 (UserPointsRecordVO) 结构如下：

字段名	类型	说明
id	long	记录ID
userId	long	用户ID
points	long	变动点数
source	integer	来源 1:购买 2:兑换码 3:签到 4:分享 5:邀请 6:被邀请 7:邀请人使用模板 8:注册 9:投稿 10:评论 11:会员
expireTime	string	过期时间
extParam	string	额外参数
createTime	string	创建时间
nickname	string	用户昵称
email	string	用户邮箱
appleUserId	string	苹果用户ID
originalTransactionId	string	原始交易ID
platform	string	平台
language	string	语言

示例请求

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

示例响应

{
  "code": 200,
  "message": "success",
  "success": true,
  "data": {
    "records": [
      {
        "id": 1001,
        "userId": 12345,
        "points": 50,
        "source": 1,
        "expireTime": "2024-10-27 10:00:00",
        "extParam": "{\"orderId\":\"123\"}",
        "createTime": "2023-10-27 10:00:00",
        "nickname": "User123",
        "email": "user@example.com",
        "appleUserId": "apple_123",
        "originalTransactionId": "txn_123",
        "platform": "IOS",
        "language": "zh-CN"
      }
    ],
    "total": 1,
    "size": 10,
    "current": 1,
    "pages": 1
  },
  "timestamp": 1698372000000
}