Skip to main content

删除可信设备接口

删除指定的可信设备记录,可传 version 做并发控制,避免覆盖他人的并发修改。

  • Scope: admin.v1.trusted-devices.manage
  • 权限项: 可信设备管理
  • 权限类型: manage
  • 接口: DELETE/api/openapi/v1/trusted-devices/{id}
使用 Authorization: Bearer <API_KEY>。应用必须配置“全部用户”范围(subject_scope={"mode":"all"});受限或无效范围在业务执行前返回 403 openapi_subject_scope_denied。各 Scope 独立授权,互不隐含。组织及应用操作主体取自可信鉴权,不接受请求参数指定。

请求参数

名称位置类型必填说明
idpathstringTrue记录标识
versionqueryintegerFalse并发控制版本

请求示例

curl --request DELETE 'https://example.invalid/api/openapi/v1/trusted-devices/11111111-1111-4111-8111-111111111111?version=1' \
  --header 'Authorization: Bearer <API_KEY>'

响应字段

204 No Content

错误处理

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

接口语义与安全边界

删除登记与设置“不可信”是不同操作。删除不等同于拉黑设备,也不承诺客户端立即下线;后续访问仍由原有策略决定。