Skip to content

预上传文件分片 ​

预上传文件分片,用于获取文件上传凭证和上传地址。上传大文件时,需要先调用此接口进行预上传,获取 OSS 上传凭证后再上传文件分片。

接口地址:

text
/papi/file/upload/preUpload

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

参数类型必填说明
md5string是文件 MD5 值
fileNamestring是文件名
totalChunksinteger是总分片数
fileSuffixstring是文件后缀名(包含点,如 .jpg)
totalSizeinteger是文件总大小
androidVersionsarray[integer]否安卓版本列表
platformstring否发起请求的平台(详见 PlatformEnum)
modulestring否上传文件的模块(app:应用市场,drive:云盘)

请求示例:

json
{
    "md5": "892aaba56fad8c9c6de6d14c8faba767",
    "fileName": "maomao2.3.4",
    "totalChunks": 1,
    "fileSuffix": ".apk",
    "totalSize": 1,
    "androidVersions": [0],
    "platform": "string",
    "module": "string"
}

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ statusinteger预上传状态(0:文件待上传,1:文件上传成功)
├─ urlstring文件地址(图片缩略图地址)
├─ appNamestring应用名
├─ versionstring应用版本号
├─ packageNamestring应用包名
├─ logostring应用 LOGO(图片地址)
├─ tokenstringOSS 服务请求 TOKEN
├─ uploadUrlstringOSS 服务请求地址
msgstring错误提示

响应示例:

json
{
    "code": 0,
    "data": {
        "status": 0,
        "url": "",
        "appName": "",
        "version": "",
        "packageName": "",
        "logo": "",
        "token": "",
        "uploadUrl": ""
    },
    "msg": ""
}

OpenAPI Docs