Skip to main content

核验可信设备申请接口

对指定申请重新核验并刷新生效策略,可能清理已失效且未冻结的待审批记录,不是只读详情接口。

  • 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 会刷新申请和生效策略,并可能删除已失效且未冻结的待审批记录;不是纯只读详情。

请求参数

名称位置类型必填说明
idpathstringTrue记录标识

请求示例

curl --request POST 'https://example.invalid/api/openapi/v1/trusted-device-requests/11111111-1111-4111-8111-111111111111/inspections' \
  --header 'Authorization: Bearer <API_KEY>'

响应字段

名称类型说明
requestobject核验后仍存在的申请
request.created_atstring创建时间
request.deviceobject申请设备信息
request.device.client_device_idstring客户端设备标识,沿用原有协议语义;maxLength=255
request.device.device_namestring设备名称;maxLength=255
request.device.login_usernamestring设备登录用户名;maxLength=255
request.device.mac_addressstring设备 MAC 标识;maxLength=32
request.device.modelstring设备型号;maxLength=255
request.device.operating_systemstring操作系统;maxLength=128
request.device.serial_numberstring设备序列号 SN;maxLength=255
request.idstring记录标识
request.lockedboolean当前策略是否冻结此申请
request.reasonstring申请或任务原因
request.review_commentstring审批意见
request.reviewed_atstring审批时间
request.reviewed_bystring审批主体标识
request.reviewed_by_emailstring审批主体邮箱
request.reviewed_by_namestring审批主体名称
request.statusstring申请或任务状态;enum=['pending', 'approved', 'rejected']
request.trusted_device_countinteger申请用户当前可信设备数
request.userobject设备所属用户快照
request.user.department_idstring部门标识
request.user.department_namestring部门名称
request.user.department_pathstring部门路径
request.user.departmentsarray用户部门快照
request.user.departments[].idstring记录标识
request.user.departments[].namestring名称
request.user.departments[].pathstringpath
request.user.emailstring用户邮箱
request.user.employee_nostring员工编号
request.user.org_idstring所属组织标识
request.user.user_idstring设备所属用户标识
request.user.user_namestring用户姓名
request.versioninteger并发控制版本
resultstring本项实际处理结果,含已处理或锁定等跳过状态;enum=['pending', 'approved', 'rejected', 'already_trusted', 'already_untrusted', 'already_processed']

错误处理

沿用 {error, detail, code} 错误结构。身份校验失败为 401/403;缺少 Scope 或非全部用户范围为 403;资源不存在为 404;冲突或旧版本为 409;参数不合法为 400/422;依赖不可用为 503。业务错误沿用控制台语义。

接口语义与安全边界

这是有副作用的审批前核验,不是只读详情查询。按当前策略重新检查;未冻结且设备已有匹配记录时可能删除失效待审批记录。申请不存在时可返回 already_processed,request 可能省略。冻结申请保留,重试结果按当前状态返回。