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

DownloadReceipt

本页内容

下载申请的回执,绑定应用、准确版本与包类型。ticket 为 null 时不能下载;该模型不提供安装包可信 SHA-256。

如何阅读本模型

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

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

字段定义

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

字段必需说明
id 是

本次下载申请的回执 ID。

类型:string

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

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

类型:string

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

完整版本 ID。从同一应用的历史版本列表或成功上传结果取得。

类型:string

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

original 为原始上传包,signed 为签名后的产物。

类型:string

查看取值约束
  • 可选值 original / signed
  • original — 原始上传包
  • signed — 签名后的安装包
platform 是

安装包平台。ipa 对应 iOS,apk 对应 Android。

类型:string

查看取值约束
  • 可选值 ipa / apk
  • ipa — iOS 安装包
  • apk — Android 安装包
size_bytes 是

文件大小,单位为字节。

类型:integer

查看取值约束
  • 最小值 1
file_name 是

包含扩展名的文件名称。

类型:string

查看取值约束
  • 格式 ^A[a-f0-9]{32}-V[a-f0-9]{32}\.(ipa|apk)$
created_at 是

记录创建时间,Unix 秒。

类型:integer

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

本次申请的下载凭证截止时间,Unix 秒。

类型:integer

查看取值约束
  • 最小值 1
ticket 是

首次交付的短期下载凭证。过期或幂等重放时可能为 null,不能仅凭回执继续下载。

类型:null | object

ticket.url 是

敏感的短期存储凭证。不要记录日志、公开或附带平台 Authorization 请求头。

类型:string

查看取值约束
  • 数据格式 uri
ticket.method 是

访问存储时使用的 HTTP 方法。

类型:string

查看取值约束
  • 固定值 GET
ticket.headers 是

访问存储时附带的请求头及值。

类型:object

ticket.expires_at 是

这个存储下载链接的有效截止时间,Unix 秒;文件传输还受客户端超时设置约束。

类型:integer

查看取值约束
  • 最小值 1

相关接口

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

作为成功响应