删除指定的可信设备记录,可传 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 独立授权,互不隐含。组织及应用操作主体取自可信鉴权,不接受请求参数指定。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
id | path | string | True | 记录标识 |
version | query | integer | False | 并发控制版本 |
请求示例
响应字段
204 No Content
错误处理
沿用 {error, detail, code} 错误结构。身份校验失败为 401/403;缺少 Scope 或非全部用户范围为 403;资源不存在为 404;冲突或旧版本为 409;参数不合法为 400/422;依赖不可用为 503。业务错误沿用控制台语义。