上传文件至系统
上传文件分片至系统。支持大文件分片上传,每次上传一个分片,全部上传完成后自动合并为完整文件。
接口地址:
由预上传文件分片接口返回(响应参数 uploadUrl 字段)。
请求方式:
text
POST请求数据类型:
text
multipart/form-dataBody 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| token | string | 是 | 由预上传文件分片接口返回 |
| md5 | string | 是 | 文件 MD5 值 |
| partNumber | integer | 是 | 分片索引 |
| file | file | 是 | 分片文件流 |
| totalChunks | integer | 是 | 总分片数 |
| fileSuffix | string | 是 | 文件后缀名(包含点,如 .jpg) |
| totalSize | integer | 是 | 文件总大小 |
| fileName | string | 是 | 文件名 |
注意: 此接口使用
multipart/form-data格式提交。
请求示例:
text
token: <由预上传文件分片接口返回>
md5: 2fd07ca9481fa8507b18b43612648cc5
partNumber: 1
file: <binary>
totalChunks: 1
fileSuffix: .png
totalSize: 1024
fileName: 2响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 返回数据 |
| ├─ status | integer | 文件是否上传完成(0.未完成,1.完成) |
| ├─ md5 | string | 文件 MD5 |
| ├─ partNumber | integer | 当前分片号 |
| ├─ uploadedChunks | array[string] | 已上传的分片列表 |
| ├─ totalChunks | integer | 总分片数 |
| ├─ url | string | 文件 URL,仅在上传完成时返回 |
| ├─ appSid | string | - |
| msg | string | 错误提示,用户可阅读 |
响应示例:
json
{
"code": 0,
"data": {
"status": 0,
"md5": "",
"partNumber": 0,
"uploadedChunks": [""],
"totalChunks": 0,
"url": "",
"appSid": ""
},
"msg": ""
}