/admin/oauth/devices
分页列出当前租户下所有设备授权码会话,支持按状态和客户端ID过滤。仅管理员可访问。
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|---|---|---|---|---|---|---|
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
| Status | Description | Schema |
|---|---|---|
| 200 | 设备授权列表 | dto.ListResponse-dto_DeviceAuthorizationListItem |
| 400 | 请求参数错误 | gitee_com_linmes_authms_base_dto.SimpleResponse |
| 401 | 未认证:请提供有效的 Bearer Token | gitee_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
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
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
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
items |
array of |
No | 统一使用 items | ||
message |
string |
No | |||
pagination |
object |
No | 分页信息(嵌套对象) | ||
timestamp |
string |
No | |||
total |
integer |
No | 总条数(平铺,便于直接读取) |
gitee_com_linmes_authms_base_dto.PageInfo
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
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
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
message |
string |
No | |||
timestamp |
string |
No |