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

GET /admin/points

分页查询租户下所有积分账户,可按状态筛选。

积分服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
page query integer No 1 页码
page_size query integer No 20 每页条数
status query string No enum: `active`, `suspended`, `closed` 状态筛选

Responses

StatusDescriptionSchema
200积分账户分页列表dto.PointAccountListResponse
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
403无权限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.PointAccountListResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
items array of

See dto.PointAccountResponse

No 统一使用 items
message string No
pagination object No 分页信息(嵌套对象)
timestamp string No
total integer 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.PageInfo

FieldTypeRequiredExampleConstraintsDescription
has_next boolean No HasNext indicates whether there is a next page
has_prev boolean No HasPrev indicates whether there is a previous page
page integer No Page is the current page number (1-based)
page_size integer No PageSize is the number of items per page
total integer No Total is the total number of items across all pages
total_pages integer No TotalPages is the total number of pages

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No