DownloadReceipt
本页内容
下载申请的回执,绑定应用、准确版本与包类型。ticket 为 null 时不能下载;该模型不提供安装包可信 SHA-256。
如何阅读本模型
先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。
应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。
字段定义
“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。
| 字段 | 必需 | 说明 |
|---|---|---|
id |
是 | 本次下载申请的回执 ID。 查看取值约束
|
app_id |
是 | 业务应用的完整 ID,来自列出应用或预留新应用的响应。 查看取值约束
|
version_id |
是 | 完整版本 ID。从同一应用的历史版本列表或成功上传结果取得。 查看取值约束
|
package_type |
是 | original 为原始上传包,signed 为签名后的产物。 查看取值约束
|
platform |
是 | 安装包平台。ipa 对应 iOS,apk 对应 Android。 查看取值约束
|
size_bytes |
是 | 文件大小,单位为字节。 查看取值约束
|
file_name |
是 | 包含扩展名的文件名称。 查看取值约束
|
created_at |
是 | 记录创建时间,Unix 秒。 查看取值约束
|
expires_at |
是 | 本次申请的下载凭证截止时间,Unix 秒。 查看取值约束
|
ticket |
是 | 首次交付的短期下载凭证。过期或幂等重放时可能为 null,不能仅凭回执继续下载。 |
ticket.url |
是 | 敏感的短期存储凭证。不要记录日志、公开或附带平台 Authorization 请求头。 查看取值约束
|
ticket.method |
是 | 访问存储时使用的 HTTP 方法。 查看取值约束
|
ticket.headers |
是 | 访问存储时附带的请求头及值。 |
ticket.expires_at |
是 | 这个存储下载链接的有效截止时间,Unix 秒;文件传输还受客户端超时设置约束。 查看取值约束
|
相关接口
下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。