跳转到主要内容
1签 (OneSign)

DeviceExport

本页内容

设备导出的回执与首次交付内容。解码后核对导出文件的 SHA-256;幂等重放可能不再返回原始内容。

如何阅读本模型

先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。

应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。

字段定义

“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。

字段必需说明
id 是

本次设备导出的回执 ID。

类型:string

查看取值约束
  • 格式 ^X[a-f0-9]{32}$
app_id 是

业务应用的完整 ID,来自列出应用或预留新应用的响应。

类型:string

查看取值约束
  • 格式 ^A[a-f0-9]{32}$
source 是

设备明细的数据来源,devices 为已登记设备,overflow 为超限记录。

类型:string

查看取值约束
  • 可选值 devices / overflow
  • devices — 已登记设备
  • overflow — 安装量超限尝试
file_name 是

包含扩展名的文件名称。

类型:string

查看取值约束
  • 格式 ^A[a-f0-9]{32}-(?:devices|overflow)\.jsonl$
format 是

接口返回的文件格式。

类型:string

查看取值约束
  • 固定值 jsonl
rows 是

本次导出包含的 JSONL 行数。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 500
next_cursor 是

传给下一次请求的 cursor。为 null 表示已到末页。

类型:string | null

查看取值约束
  • string (格式 ^F(?:[a-f0-9]{24,64}|[a-f0-9]{8}-[a-f0-9]{16}|instance:[a-f0-9]{40})$)
sha256 是

实际文件、分片或导出内容的 SHA-256,小写十六进制。

类型:string

查看取值约束
  • 格式 ^[a-f0-9]{64}$
content_base64 是

首次交付的 Base64 导出内容;幂等重放可能不再返回内容。取得后先解码,再校验 sha256。

类型:string | null

查看取值约束
  • 最多字符 1500000

相关接口

下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。

作为成功响应