Skip to content

分块上传提交完成

适用版本>=v7.0.2412b.20241226

接口说明:分块上传提交完成

请求说明

请求地址配置域名+/openapi+/v7/filetransfer/file/upload/commit
请求方法POST
签名方式KSO-1(配置域名+/openapi不参与签名)
权限要求文件摆渡(应用授权) kso.filetransfer.readwrite

请求头(Header)

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

请求体(Body)

名称类型是否必填说明
upload_idstring上传标识
account_idstring三方用户ID
account_typestring可选值:third_user, 表示account_id为三方用户ID
boxstringoutbox:发件箱 或 inbox:收件箱
task_idstring任务ID, 单个文件上传不需要传
parent_idstring父目录ID
namestring文件名称
sizeinteger文件大小
outbox_company_idstring发件箱租户ID 非必传,当box=inbox时 必传
outbox_file_idstring发件箱文件ID 非必传,当box=inbox时 必传
transfer_idstring传输ID
multipart_store_responseobject[]存储回传信息,从第二步响应中获取
part_numberinteger分块编号
store_responseobject[]存储响应数据
namestring名称
valuestring

请求体示例

json
{
  "upload_id": "",
  "account_id": "1",
  "account_type": "third_user",
  "box": "inbox",
  "task_id": "45454545",
  "parent_id": "4545",
  "name": "",
  "size": 100,
  "outbox_company_id": "1",
  "outbox_file_id": "485545",
  "multipart_store_response": [
    {
      "part_number": 1,
      "store_response": [
        {
          "name": "string",
          "value": "string"
        }
      ]
    },
    {
      "part_number": 2,
      "store_response": [
        {
          "name": "string",
          "value": "string"
        }
      ]
    }
  ]
}

响应体(Response)

名称类型说明
dataobject
file_idstring文件id
is_finishinteger是否完成,0:未完成,1:已完成
codeinteger错误码
msgstring状态信息
detailstring详细信息

响应体示例

json
{
  "data": {
    "file_id": "",
    "is_finish": 0
  },
  "msg": "ok",
  "code": 20000000
}