GET /points/{user_id}/transactions

分页查询用户的积分交易历史,支持按类型筛选,按创建时间倒序排列。

积分服务 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
user_id path string 是 用户ID
page query integer 否 1 页码
page_size query integer 否 20 每页条数
type query string 否 enum: `earn`, `spend`, `expire`, `freeze`, `unfreeze`, `refund`, `adjust` 交易类型

响应

引用的 Schema

service-core/base/dto.PageInfo

字段类型必填示例约束描述
has_next boolean 否 HasNext indicates whether there is a next page
has_prev boolean 否 HasPrev indicates whether there is a previous page
page integer 否 Page is the current page number (1-based)
page_size integer 否 PageSize is the number of items per page
total integer 否 Total is the total number of items across all pages
total_pages integer 否 TotalPages is the total number of pages

service-core/base/dto.SimpleResponse

字段类型必填示例约束描述
code integer 否
message string 否
timestamp string 否

service-point/internal/handler/dto.PointTransactionListResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-point/internal/handler/dto.PointTransactionResponse

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)

service-point/internal/handler/dto.PointTransactionResponse

字段类型必填示例约束描述
account_id string 否 01ARZ3NDEKTSV4RRFFQ69G5FAV
amount integer 否 100
balance_after integer 否 1500
balance_before integer 否 1400
created_at string 否 2026-04-15T10:30:00Z
description string 否 每日签到奖励
expires_at string 否 2027-01-15T10:30:00Z
id string 否 01ARZ3NDEKTSV4RRFFQ69G5FAV
idempotency_key string 否 ik_abc123
reason string 否 签到奖励
related_id string 否 01ARZ3NDEKTSV4RRFFQ69G5FAV
source string 否 daily_checkin
status string 否 completed
type string 否 earn
updated_at string 否 2026-04-15T10:30:00Z
user_id string 否 usr_example_001