Skip to main content

查询可信设备申请接口

分页查询成员提交的可信设备申请,支持按关键词和申请状态 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 独立授权,互不隐含。组织及应用操作主体取自可信鉴权,不接受请求参数指定。

请求参数

名称位置类型必填说明
keywordquerystringFalse搜索关键词
statusquerystringFalse申请或任务状态

请求示例

curl --request GET 'https://example.invalid/api/openapi/v1/trusted-device-requests' \
  --header 'Authorization: Bearer <API_KEY>'

响应字段

名称类型说明
countsobject各审批状态数量
counts.approvedinteger已同意数量
counts.pendinginteger待审批数量
counts.rejectedinteger已拒绝数量
itemsarray结果列表
items[].created_atstring创建时间
items[].deviceobject申请设备信息
items[].device.client_device_idstring客户端设备标识,沿用原有协议语义;maxLength=255
items[].device.device_namestring设备名称;maxLength=255
items[].device.login_usernamestring设备登录用户名;maxLength=255
items[].device.mac_addressstring设备 MAC 标识;maxLength=32
items[].device.modelstring设备型号;maxLength=255
items[].device.operating_systemstring操作系统;maxLength=128
items[].device.serial_numberstring设备序列号 SN;maxLength=255
items[].idstring记录标识
items[].lockedboolean当前策略是否冻结此申请
items[].reasonstring申请或任务原因
items[].review_commentstring审批意见
items[].reviewed_atstring审批时间
items[].reviewed_bystring审批主体标识
items[].reviewed_by_emailstring审批主体邮箱
items[].reviewed_by_namestring审批主体名称
items[].statusstring申请或任务状态;enum=['pending', 'approved', 'rejected']
items[].trusted_device_countinteger申请用户当前可信设备数
items[].userobject设备所属用户快照
items[].user.department_idstring部门标识
items[].user.department_namestring部门名称
items[].user.department_pathstring部门路径
items[].user.departmentsarray用户部门快照
items[].user.departments[].idstring记录标识
items[].user.departments[].namestring名称
items[].user.departments[].pathstringpath
items[].user.emailstring用户邮箱
items[].user.employee_nostring员工编号
items[].user.org_idstring所属组织标识
items[].user.user_idstring设备所属用户标识
items[].user.user_namestring用户姓名
items[].versioninteger并发控制版本
pageinteger页码,从 1 开始
page_sizeinteger每页条数,最多 100
totalinteger总记录数

错误处理

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

接口语义与安全边界

包含申请人及设备信息、申请理由、审批意见和审批主体信息;locked 表示当前策略冻结申请,不能据此绕过审批校验。