资源工坊

【分块上传】签发分块上传地址 ​

适用版本>=v7.0.2405a.20240509

接口说明：【分块上传】第二步，注意事项可参考文件传输概述

请求说明 ​

请求地址配置域名+/graph+/v7/multipart_upload_tasks/{upload_id}/sign
请求方法POST
签名方式WPS-4签名/WPS-4-GM签名（配置域名+/graph不参与签名）
权限要求更新文件（用户授权） kso.file.write 应用管理文件（应用授权） kso.appdrive.file.write

请求头（Header） ​

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

路径参数（Path） ​

名称类型是否必填说明
upload_idstring是上传标识，从初始化分块上传的响应中获取，长度不超过1024位

请求体（Body） ​

名称类型是否必填说明
parts_infoobject[]是<= 1024 items
∟ hashobject否文件分块的hash信息，用于签名和完整性校验
∟ ∟ sumstring是哈希结果，长度不超过1024位
∟ ∟ typestring是哈希类型，仅支持sha256
∟ numberinteger是分块编号，从1开始

请求体示例 ​

{
  "parts_info": [
    {
      "hash": {
        "sum": "string",
        "type": "sha256"
      },
      "number": 1
    }
  ]
}

响应体（Response） ​

名称类型说明
dataobject签发分块上传地址返回体
∟ store_requestsobject[]第二步各块上传请求信息，<= 1024 items
∟ ∟ part_numberinteger分块编号
∟ ∟ store_requestobject第二步上传请求信息
∟ ∟ ∟ body_paramsobject[]存储时需要带入到form-data中的信息，<= 1024 items
∟ ∟ ∟ ∟ namestring名称，长度不超过1024位
∟ ∟ ∟ ∟ valuestring值，长度不超过1024位
∟ ∟ ∟ headersobject[]存储上传时需要携带的头部信息，<= 1024 items
∟ ∟ ∟ ∟ namestring名称，长度不超过1024位
∟ ∟ ∟ ∟ valuestring值，长度不超过1024位
∟ ∟ methodstring存储上传方法(应用文档仅返回PUT)
∟ ∟ urlstring存储上传使用的地址
∟ store_response_keysobject第二步上传响应中的回传字段，调用方需要根据这些字段从第二步响应中取出回传信息，并在第三步按照文件分块的顺序进行回传
∟ ∟ body_keysstring[]响应体中的回传字段，<= 1024 items，长度不超过1024位
∟ ∟ header_keysstring[]响应头中的回传字段，<= 1024 items，长度不超过1024位
codeinteger错误码，参照《错误码说明》
msgstring状态信息
detailstring详细信息

响应体示例 ​

{
  "data": {
    "store_requests": [
      {
        "part_number": 0,
        "store_request": {
          "body_params": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "headers": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "method": "string",
          "url": "string"
        }
      }
    ],
    "store_response_keys": {
      "body_keys": [
        "string"
      ],
      "header_keys": [
        "string"
      ]
    }
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}