Skip to main content

审批可信设备申请接口

批量审批可信设备申请，status 取 approved 或 rejected，拒绝时必须填写 comment，ids 单次最多 100 条。

  • Scope: admin.v1.trusted-device-requests.review
  • 权限项: 可信设备申请审批
  • 权限类型: manage
  • 接口: POST/api/openapi/v1/trusted-device-requests/reviews
使用 Authorization: Bearer <API_KEY>。应用必须配置“全部用户”范围（subject_scope={"mode":"all"}）；受限或无效范围在业务执行前返回 403 openapi_subject_scope_denied。各 Scope 独立授权，互不隐含。组织及应用操作主体取自可信鉴权，不接受请求参数指定。 单次最多 100 条。审批同意创建可信设备，拒绝不创建设备且必须填写 comment。复用原有事务、锁及通知；locked、already_processed 等是逐项跳过结果。重试可能返回 already_processed，不承诺重放原审批响应。

请求参数

名称位置类型必填说明
commentbodystringFalse审批意见；拒绝时必填；maxLength=1000
idsbodyarrayTrue目标记录标识列表；maxItems=100
statusbodystringTrue申请或任务状态；enum=['approved', 'rejected']

请求示例

curl --request POST 'https://example.invalid/api/openapi/v1/trusted-device-requests/reviews' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"comment": "example", "ids": ["example"], "status": "approved"}'

响应字段

名称类型说明
itemsarray结果列表
items[].idstring记录标识
items[].resultstring本项实际处理结果，含已处理或锁定等跳过状态；enum=['approved', 'rejected', 'already_trusted', 'already_untrusted', 'already_processed', 'locked']

错误处理

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

接口语义与安全边界

审批会再次执行策略及设备校验，不要求调用方先核验。逐项检查 approved/rejected/locked/already_processed 等结果；HTTP 200 不代表每项均已审批成功。