【分块上传】初始化

适用版本>=v7.0.2404b.20240425

接口说明：【分块上传】初始化

请求说明

请求地址	配置域名+/graph+/v7/drives/{drive_id}/files/{parent_id}/create_multipart_upload_task
请求方法	POST
签名方式	WPS-4签名/WPS-4-GM签名（配置域名+/graph不参与签名）
权限要求	应用身份管理文档（应用授权） kso.appfile.readwrite

请求头（Header）

名称	是否必填	说明
Content-Type	是	固定为: application/json
Wps-Docs-Date	是	取当前时间， 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization	是	计算方法参考签名说明
Authorization	是	授权凭证，格式为: Bearer {access_token}

路径参数（Path）

名称	类型	是否必填	说明
drive_id	string	是	驱动盘id，长度不超过1024位
parent_id	string	是	父目录id（应用文档为0），长度不超过1024位

查询参数（Query）

名称	类型	是否必填	说明
_w_third_user_id	string	否	用户id，长度范围[1,64]

请求体（Body）

名称	类型	是否必填	说明
file_id	string	否	文件id,更新上传时指定文件id，长度范围[1,64]
internal	boolean	否	是否内部上传，目前仅支持false
name	string	否	文件名,更新文件时忽略(包含后缀,不支持"/:*?"<>|"特殊符号)，长度范围[1,240]
size	integer	是	文件大小

请求体示例

{
  "file_id": "string",
  "internal": true,
  "name": "string",
  "size": 0
}

响应体（Response）

名称	类型	说明
data	object	初始化分块上传返回体
∟ part_count	integer	分块数量
∟ part_size	integer	分块大小
∟ upload_id	string	上传标识，用于后续签发、提交或取消分块上传
code	integer	错误码，参照《错误码说明》
msg	string	状态信息
detail	string	详细信息

响应体示例

{
  "data": {
    "part_count": 0,
    "part_size": 0,
    "upload_id": "string"
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}