分页查询成员提交的可信设备申请,支持按关键词和申请状态 status 过滤。
- Scope:
admin.v1.trusted-device-requests.read - 权限项: 可信设备申请读取
- 权限类型: read
- 接口: GET
/api/openapi/v1/trusted-device-requests
Authorization: Bearer <API_KEY>。应用必须配置“全部用户”范围(subject_scope={"mode":"all"});受限或无效范围在业务执行前返回 403 openapi_subject_scope_denied。各 Scope 独立授权,互不隐含。组织及应用操作主体取自可信鉴权,不接受请求参数指定。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
keyword | query | string | False | 搜索关键词 |
status | query | string | False | 申请或任务状态 |
请求示例
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
counts | object | 各审批状态数量 |
counts.approved | integer | 已同意数量 |
counts.pending | integer | 待审批数量 |
counts.rejected | integer | 已拒绝数量 |
items | array | 结果列表 |
items[].created_at | string | 创建时间 |
items[].device | object | 申请设备信息 |
items[].device.client_device_id | string | 客户端设备标识,沿用原有协议语义;maxLength=255 |
items[].device.device_name | string | 设备名称;maxLength=255 |
items[].device.login_username | string | 设备登录用户名;maxLength=255 |
items[].device.mac_address | string | 设备 MAC 标识;maxLength=32 |
items[].device.model | string | 设备型号;maxLength=255 |
items[].device.operating_system | string | 操作系统;maxLength=128 |
items[].device.serial_number | string | 设备序列号 SN;maxLength=255 |
items[].id | string | 记录标识 |
items[].locked | boolean | 当前策略是否冻结此申请 |
items[].reason | string | 申请或任务原因 |
items[].review_comment | string | 审批意见 |
items[].reviewed_at | string | 审批时间 |
items[].reviewed_by | string | 审批主体标识 |
items[].reviewed_by_email | string | 审批主体邮箱 |
items[].reviewed_by_name | string | 审批主体名称 |
items[].status | string | 申请或任务状态;enum=['pending', 'approved', 'rejected'] |
items[].trusted_device_count | integer | 申请用户当前可信设备数 |
items[].user | object | 设备所属用户快照 |
items[].user.department_id | string | 部门标识 |
items[].user.department_name | string | 部门名称 |
items[].user.department_path | string | 部门路径 |
items[].user.departments | array | 用户部门快照 |
items[].user.departments[].id | string | 记录标识 |
items[].user.departments[].name | string | 名称 |
items[].user.departments[].path | string | path |
items[].user.email | string | 用户邮箱 |
items[].user.employee_no | string | 员工编号 |
items[].user.org_id | string | 所属组织标识 |
items[].user.user_id | string | 设备所属用户标识 |
items[].user.user_name | string | 用户姓名 |
items[].version | integer | 并发控制版本 |
page | integer | 页码,从 1 开始 |
page_size | integer | 每页条数,最多 100 |
total | integer | 总记录数 |
错误处理
沿用 {error, detail, code} 错误结构。身份校验失败为 401/403;缺少 Scope 或非全部用户范围为 403;资源不存在为 404;冲突或旧版本为 409;参数不合法为 400/422;依赖不可用为 503。业务错误沿用控制台语义。