Skip to content

提交分块上传

适用版本>=v7.0.2512.20251225

接口说明:提交分块上传

请求说明

请求地址配置域名+/openapi+/v7/appfiles/multipart_upload_tasks/{upload_id}/commit
请求方法POST
签名方式KSO-1(配置域名+/openapi不参与签名)
权限要求应用身份管理文档(应用授权) kso.appfiles.readwrite

请求头(Header)

Header参数类型是否必填说明
X-Kso-DatestringRFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-AuthorizationstringKSO-1 签名值,详见《签名方法》
Authorizationstring授权凭证,格式为:Bearer {access_token}

路径参数(Path)

名称类型是否必填说明
upload_idstring上传id

查询参数(Query)

名称类型是否必填说明
_w_third_user_idstring操作者id

请求体(Body)

字段名类型说明
multipart_store_responsearray[object]存储回传信息,根据第一步响应的 store_response_keys 从第二步响应中获取
∟∟ namestring名称
∟∟ valuestring
part_numberinteger分块编号,从 1 开始
store_responsearray[object]存储内容数组
∟∟ namestring名称
∟∟ valuestring

请求体示例

json
{
  "multipart_store_response": [
    {
      "part_number": 0,
      "store_response": [
        {
          "name": "string",
          "value": "string"
        }
      ]
    }
  ]
}

响应体(Response)

名称类型说明
dataobject返回的数据对象
idstring文件 ID
drive_idstring驱动盘 ID
parent_idstring父目录 ID(示例:"0")
created_byobject创建者信息
∟∟ idstring身份 ID
∟∟ typestringEnum: "sp"
modified_byobject修改者信息
∟∟ idstring身份 ID
∟∟ typestringEnum: "sp"
sizeinteger文件大小(字节)
versioninteger文件版本号
typestring文件类型 Enum: "folder","file"
namestring文件名称
ctimeinteger创建时间
mtimeinteger修改时间
sharedboolean是否开启分享(应用文档:false)
link_urlstring链接 URL(应用文档:为空字符串)
link_idstring链接 ID(应用文档:为空字符串)
codeint错误码
msgstring状态信息
detailstring详细信息

响应体示例

json
{
    "data": {
        "id": "350745587089408",
        "drive_id": "349087249465344",
        "parent_id": "0",
        "created_by": {
            "id": "userId",
            "type": "sp"
        },
        "modified_by": {
            "id": "userId",
            "type": "sp"
        },
        "size": 14498,
        "version": 1,
        "type": "file",
        "name": "测试文件.docx",
        "ctime": 1764928529,
        "mtime": 1764928529,
        "shared": false,
        "link_url": "",
        "link_id": ""
    },
    "code": 0,
    "detail": "",
    "msg": "ok"
}