Skip to main content

下载可信设备导入模板接口

下载批量导入可信设备使用的表格模板,Accept-Language 可取 zh-CN、zh-TW 或 en,未传或不支持时回退默认语言。

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

请求参数

名称位置类型必填说明
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/import-template' \
  --header 'Authorization: Bearer <API_KEY>'

响应字段

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

错误处理

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

接口语义与安全边界

下载的是服务端生成的固定字段、规则和示例模板,不解析调用方上传的工作簿,也不包含组织内员工或设备记录。