Skip to main content

导出可信设备接口

按与查询接口一致的过滤条件导出可信设备清单文件，Accept-Language 控制导出内容的语言。

  • Scope: admin.v1.trusted-devices.read
  • 权限项: 可信设备读取
  • 权限类型: read
  • 接口: GET/api/openapi/v1/trusted-devices/export
使用 Authorization: Bearer <API_KEY>。应用必须配置“全部用户”范围（subject_scope={"mode":"all"}）；受限或无效范围在业务执行前返回 403 openapi_subject_scope_denied。各 Scope 独立授权，互不隐含。组织及应用操作主体取自可信鉴权，不接受请求参数指定。 沿用现有导出筛选、CSV 格式和最多 10,000 行限制；超限不承诺导出全量。

请求参数

名称位置类型必填说明
keywordquerystringFalse搜索关键词
trustedquerystringFalse是否可信
created_fromquerystringFalse创建时间起点
created_toquerystringFalse创建时间终点
Accept-LanguageheaderstringFalseDownload language: zh-CN, zh-TW, or en. Omitted or unsupported languages fall back to zh-CN.

请求示例

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

响应字段

返回文件内容，通过 Content-Type 和 Content-Disposition 标识格式与下载文件名。

错误处理

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

接口语义与安全边界

CSV 文件安全编码：对以公式起始字符（含全角形式、前置空白）或制表/换行字符开头的字段增加一个制表符前缀，并由 CSV 编码器引用和转义。数据库及 JSON 查询原值不变；程序读取 CSV 会读到这个前缀，不应把它当作原始标识。用于表格查看的安全编码不保证经其他软件转换、去前缀或再次保存后仍安全。设备导出最多 10,000 行；超过时可能截断，请使用分页查询获取完整数据。