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

Upload

本页内容

一次安装包上传的任务状态。上传任务 ID 用于查询和恢复;state=succeeded 且取得 version_id 后,才表示原包版本已保存。

如何阅读本模型

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

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

字段定义

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

字段必需说明
id 是

上传任务 ID,与创建上传任务响应中的 data.id 相同。创建后立即保存;查询进度、申请上传凭证和恢复上传都使用这个完整 ID。

类型:string

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

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

类型:string

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

当前记录的处理状态或请求筛选的状态。

类型:string

查看取值约束
  • 可选值 uploading / validating / succeeded / failed / cancelled
  • uploading — 等待或正在上传
  • validating — 后台校验中
  • succeeded — 处理成功
  • failed — 处理失败
  • cancelled — 已取消
size_bytes 是

文件大小,单位为字节。

类型:integer

查看取值约束
  • 最小值 22
expires_at 是

上传任务的有效截止时间,Unix 秒;上传凭证还有自己的有效期。

类型:integer

version_id 是

上传校验成功后保存的版本 ID。尚未成功时按返回的空值处理。

类型:string | null

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

上传任务失败的业务原因。查询请求可正常返回 HTTP 200,仍需检查 state。

类型:string | null

transfer_mode 否

single 为整包上传,multipart 为分片上传。

类型:string

查看取值约束
  • 可选值 single / multipart
  • single — 整包上传
  • multipart — 分片上传
format 否

接口返回的文件格式。

类型:string

查看取值约束
  • 可选值 ipa / apk
part_size_bytes 否

分片字节数。按此大小切分文件,最后一片使用剩余字节。

类型:integer

查看取值约束
  • 最小值 0
part_count 否

分片总数,整包上传为 0。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 1024

相关接口

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

作为成功响应