GET `/points/{user_id}/expiring`

查询用户账户中在未来N天内即将过期的积分明细，包含每笔的来源、数额、到期日、剩余天数。

积分服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`user_id`	`path`	`string`	是				用户ID
`days`	`query`	`integer`	否	`30`			查询天数范围

响应

状态	描述	Schema
200	即将过期积分详情	`service-point/internal/handler/dto.ExpiringPointDetailResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
404	用户不存在	`service-core/base/dto.SimpleResponse`
500	服务器内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

service-core/base/dto.SimpleResponse

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

service-point/internal/handler/dto.ExpiringPointDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-point/internal/handler/dto.ExpiringPointsResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-point/internal/handler/dto.ExpiringPointResponse

字段	类型	必填	示例	约束	描述
`amount`	`integer`	否	`500`
`days_left`	`integer`	否	`7`
`expires_at`	`string`	否	`2026-06-15T00:00:00Z`
`source`	`string`	否	`signup_bonus`
`transaction_id`	`string`	否	`01ARZ3NDEKTSV4RRFFQ69G5FAV`

service-point/internal/handler/dto.ExpiringPointsResponse

字段	类型	必填	示例	约束	描述
`days_threshold`	`integer`	否	`30`
`expiring_points`	array of 参见 `service-point/internal/handler/dto.ExpiringPointResponse`	否
`total_expiring`	`integer`	否	`1500`
`user_id`	`string`	否	`usr_example_001`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓