对指定申请重新核验并刷新生效策略,可能清理已失效且未冻结的待审批记录,不是只读详情接口。
- Scope:
admin.v1.trusted-device-requests.review - 权限项: 可信设备申请审批
- 权限类型: manage
- 接口: POST
/api/openapi/v1/trusted-device-requests/{id}/inspections
Authorization: Bearer <API_KEY>。应用必须配置“全部用户”范围(subject_scope={"mode":"all"});受限或无效范围在业务执行前返回 403 openapi_subject_scope_denied。各 Scope 独立授权,互不隐含。组织及应用操作主体取自可信鉴权,不接受请求参数指定。
该 POST 会刷新申请和生效策略,并可能删除已失效且未冻结的待审批记录;不是纯只读详情。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
id | path | string | True | 记录标识 |
请求示例
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
request | object | 核验后仍存在的申请 |
request.created_at | string | 创建时间 |
request.device | object | 申请设备信息 |
request.device.client_device_id | string | 客户端设备标识,沿用原有协议语义;maxLength=255 |
request.device.device_name | string | 设备名称;maxLength=255 |
request.device.login_username | string | 设备登录用户名;maxLength=255 |
request.device.mac_address | string | 设备 MAC 标识;maxLength=32 |
request.device.model | string | 设备型号;maxLength=255 |
request.device.operating_system | string | 操作系统;maxLength=128 |
request.device.serial_number | string | 设备序列号 SN;maxLength=255 |
request.id | string | 记录标识 |
request.locked | boolean | 当前策略是否冻结此申请 |
request.reason | string | 申请或任务原因 |
request.review_comment | string | 审批意见 |
request.reviewed_at | string | 审批时间 |
request.reviewed_by | string | 审批主体标识 |
request.reviewed_by_email | string | 审批主体邮箱 |
request.reviewed_by_name | string | 审批主体名称 |
request.status | string | 申请或任务状态;enum=['pending', 'approved', 'rejected'] |
request.trusted_device_count | integer | 申请用户当前可信设备数 |
request.user | object | 设备所属用户快照 |
request.user.department_id | string | 部门标识 |
request.user.department_name | string | 部门名称 |
request.user.department_path | string | 部门路径 |
request.user.departments | array | 用户部门快照 |
request.user.departments[].id | string | 记录标识 |
request.user.departments[].name | string | 名称 |
request.user.departments[].path | string | path |
request.user.email | string | 用户邮箱 |
request.user.employee_no | string | 员工编号 |
request.user.org_id | string | 所属组织标识 |
request.user.user_id | string | 设备所属用户标识 |
request.user.user_name | string | 用户姓名 |
request.version | integer | 并发控制版本 |
result | string | 本项实际处理结果,含已处理或锁定等跳过状态;enum=['pending', 'approved', 'rejected', 'already_trusted', 'already_untrusted', 'already_processed'] |
错误处理
沿用 {error, detail, code} 错误结构。身份校验失败为 401/403;缺少 Scope 或非全部用户范围为 403;资源不存在为 404;冲突或旧版本为 409;参数不合法为 400/422;依赖不可用为 503。业务错误沿用控制台语义。