预上传文件分片
预上传文件分片,用于获取文件上传凭证和上传地址。上传大文件时,需要先调用此接口进行预上传,获取 OSS 上传凭证后再上传文件分片。
接口地址:
text
/papi/file/upload/preUpload请求方式:
text
POST请求数据类型:
text
application/jsonHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Body 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| md5 | string | 是 | 文件 MD5 值 |
| fileName | string | 是 | 文件名 |
| totalChunks | integer | 是 | 总分片数 |
| fileSuffix | string | 是 | 文件后缀名(包含点,如 .jpg) |
| totalSize | integer | 是 | 文件总大小 |
| androidVersions | array[integer] | 否 | 安卓版本列表 |
| platform | string | 否 | 发起请求的平台(详见 PlatformEnum) |
| module | string | 否 | 上传文件的模块(app:应用市场,drive:云盘) |
请求示例:
json
{
"md5": "892aaba56fad8c9c6de6d14c8faba767",
"fileName": "maomao2.3.4",
"totalChunks": 1,
"fileSuffix": ".apk",
"totalSize": 1,
"androidVersions": [0],
"platform": "string",
"module": "string"
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 返回数据 |
| ├─ status | integer | 预上传状态(0:文件待上传,1:文件上传成功) |
| ├─ url | string | 文件地址(图片缩略图地址) |
| ├─ appName | string | 应用名 |
| ├─ version | string | 应用版本号 |
| ├─ packageName | string | 应用包名 |
| ├─ logo | string | 应用 LOGO(图片地址) |
| ├─ token | string | OSS 服务请求 TOKEN |
| ├─ uploadUrl | string | OSS 服务请求地址 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": {
"status": 0,
"url": "",
"appName": "",
"version": "",
"packageName": "",
"logo": "",
"token": "",
"uploadUrl": ""
},
"msg": ""
}