Skip to content

上传文件至系统 ​

上传文件分片至系统。支持大文件分片上传,每次上传一个分片,全部上传完成后自动合并为完整文件。

接口地址:

由预上传文件分片接口返回(响应参数 uploadUrl 字段)。

请求方式:

text
POST

请求数据类型:

text
multipart/form-data

Body 参数:

参数类型必填说明
tokenstring是由预上传文件分片接口返回
md5string是文件 MD5 值
partNumberinteger是分片索引
filefile是分片文件流
totalChunksinteger是总分片数
fileSuffixstring是文件后缀名(包含点,如 .jpg)
totalSizeinteger是文件总大小
fileNamestring是文件名

注意: 此接口使用 multipart/form-data 格式提交。

请求示例:

text
token: <由预上传文件分片接口返回>
md5: 2fd07ca9481fa8507b18b43612648cc5
partNumber: 1
file: <binary>
totalChunks: 1
fileSuffix: .png
totalSize: 1024
fileName: 2

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ statusinteger文件是否上传完成(0.未完成,1.完成)
├─ md5string文件 MD5
├─ partNumberinteger当前分片号
├─ uploadedChunksarray[string]已上传的分片列表
├─ totalChunksinteger总分片数
├─ urlstring文件 URL,仅在上传完成时返回
├─ appSidstring-
msgstring错误提示,用户可阅读

响应示例:

json
{
    "code": 0,
    "data": {
        "status": 0,
        "md5": "",
        "partNumber": 0,
        "uploadedChunks": [""],
        "totalChunks": 0,
        "url": "",
        "appSid": ""
    },
    "msg": ""
}

OpenAPI Docs