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

GET /points/{user_id}

根据用户ID获取积分账户信息,包含可用余额、冻结余额、总获得、总消费、过期积分、积分类型、兑换比率等。

积分服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
user_id path string Yes 用户ID

Responses

StatusDescriptionSchema
200积分账户详情dto.PointAccountDetailResponse
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.PointAccountDetailResponse

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

dto.PointAccountResponse

FieldTypeRequiredExampleConstraintsDescription
balance integer No 1500
created_at string No 2026-01-15T10:30:00Z
exchange_rate integer No 100
expired_points integer No 100
frozen_balance integer No 200
id string No 01ARZ3NDEKTSV4RRFFQ69G5FAV
points_type string No cash_equivalent
status string No active
tenant_id string No tnt_example_001
total_earned integer No 5000
total_spent integer No 3500
updated_at string No 2026-04-10T14:20:00Z
user_id string No usr_example_001
version integer No 3

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No