A AuthMS API Wiki API Reference iam.tianv.com →

GET /points/{user_id}/expiring

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

积分服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
user_id path string Yes 用户ID
days query integer No 30 查询天数范围

Responses

StatusDescriptionSchema
200即将过期积分详情dto.ExpiringPointDetailResponse
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
404用户不存在gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.ExpiringPointDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.ExpiringPointsResponse No
message string No
timestamp string No

dto.ExpiringPointResponse

FieldTypeRequiredExampleConstraintsDescription
amount integer No 500
days_left integer No 7
expires_at string No 2026-06-15T00:00:00Z
source string No signup_bonus
transaction_id string No 01ARZ3NDEKTSV4RRFFQ69G5FAV

dto.ExpiringPointsResponse

FieldTypeRequiredExampleConstraintsDescription
days_threshold integer No 30
expiring_points array of

See dto.ExpiringPointResponse

No
total_expiring integer No 1500
user_id string No usr_example_001

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No