初始化分块上传

适用版本>=v7.0.2507.20250724

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

标签：文件-上传下载

请求说明

字段	值
请求地址	配置域名+/openapi+/v7/drives/{drive_id}/files/{parent_id}/create_multipart_upload_task
HTTP 方法	POST
接口描述	分块上传步骤: 1.分块上传任务初始化 2.签发分块上传的块上传地址 3.上传分块实体 4.提交分块上传
签名方式	KSO-1（配置域名+/openapi不参与签名）
限频策略	无
权限要求	查询和管理文件(用户授权) kso.file.readwrite 查询和管理文件(应用授权) kso.file.readwrite

请求头 (Headers)

属性名	类型	是否必填	描述	可选值
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT	-
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》	-
Authorization	string	是	授权凭证，格式为：Bearer {access_token}	-

路径参数 (Path)

属性名	类型	是否必填	描述	可选值
drive_id	string	是	驱动盘id	-
parent_id	string	是	文件夹id（根目录时为0）	-

请求体(Body)

请求体格式: application/json

没有可用的数据

请求体示例

{
  "file_id": "string",
  "hashes": [
    {
      "sum": "string",
      "type": "s2s"
    }
  ],
  "internal": true,
  "name": "string",
  "on_name_conflict": "string",
  "on_parent_path_conflict": "string",
  "parent_path": [
    "string"
  ],
  "size": 0,
  "upload_scene": "normal_upload"
}

响应体(Response)

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例

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