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

GET /admin/oauth/devices

分页列出当前租户下所有设备授权码会话,支持按状态和客户端ID过滤。仅管理员可访问。

OAuth `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
page query integer No 1 页码
page_size query integer No 20 每页数量
status query string No 状态过滤(pending/authorized/denied/expired)
client_id query string No 客户端ID过滤

Responses

StatusDescriptionSchema
200设备授权列表dto.ListResponse-dto_DeviceAuthorizationListItem
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证:请提供有效的 Bearer Tokengitee_com_linmes_authms_base_dto.SimpleResponse
403权限不足:需要管理员权限gitee_com_linmes_authms_base_dto.SimpleResponse
500服务内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.DeviceAuthorizationListItem

FieldTypeRequiredExampleConstraintsDescription
client_id string No app-123
created_at string No 2026-01-15T10:20:00Z
device_code string No 01ARZ3NDEKTSV4RRFFQ69G5FAV
expires_at string No 2026-01-15T10:30:00Z
interval integer No 5
poll_count integer No 3
scope string No openid profile
status string No pending
updated_at string No 2026-01-15T10:22:00Z
user_code string No BDJW-DSXQ
user_id string No user-abc

dto.ListResponse-dto_DeviceAuthorizationListItem

FieldTypeRequiredExampleConstraintsDescription
code integer No
items array of

See dto.DeviceAuthorizationListItem

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

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