1.1. 分块上传初始化
1.1.1. 基本信息
Path: /v1/upload/initiateMultipartUpload
Method: POST
接口描述:
此接口适用于较大的文件上传,如视频上传。
上传流程:先通过此接口初始化上传获取的uploadID,然后把文件分块调用分块上传接口,最后分块上传完毕后再调用分块完成接口返回对应的文件地址,上传流程完毕。
1.1.2. 请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Authorization | 是 | 上传请求的授权签名,clientId:签名串,具体见请求签名 | ||
Content-Type | application/x-www-form-urlencoded | 是 | application/x-www-form-urlencoded | RFC 2616 中定义的 HTTP 请求内容类型(MIME),此头部用于描述待上传对象的内容类型,将作为对象元数据保存 |
Content-MD5 | 是 | Base64编码的请求体内容MD5校验值,无请求体则传空 | ||
Content-Length | 0 | 是 | 0 | 请求体内容大小,无请求体则传0 |
Date | Fri, 01 Jan 2021 00:00:00 GMT | 是 | Fri, 01 Jan 2021 00:00:00 GMT | RFC2822格式 |
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
name | 是 | example.jpeg | 文件名称。如名称与之前的相同 则会覆盖,暂时只支持格式:jpeg/jpg/png/gif/mp4/mp3 |
1.1.3. 返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 非必须 | |||
message | string | 非必须 | |||
content | object | 非必须 | |||
├─ uploadId | string | 非必须 | 分块上传ID |
{
"code": 1000,
"message": "success",
"content": {
"uploadId": "1634611117bc2f9d42df8707bc1720dd97f0f376960f89c03588ea6d30bfda16e167380ebc"
}
}