创建文件分片上传任务

POST/

创建一个文件分片上传任务，返回 TaskId 供后续上传分片时使用。

适用于大文件上传场景，将文件切割为多个分片分别上传，每个分片固定 16 MB，最后一个分片可小于 16 MB。

请求参数

Header 参数

Authorization必填string

Bearer <access_token>

X-TC-Action必填string

接口名称，固定值 `CreateUploadTask`

X-TC-Timestamp必填string

当前 UNIX 时间戳（秒）

X-TC-Language必填string

响应语言，必填，支持 zh-CN / zh-TW / en-US / vi-VN / th-TH / ms-MY / id-ID

Body 请求体

multipart/form-data

BusinessTypestring

业务类型，枚举值： - `TEMPLATE`：模版 - `FLOW`：合同 - `SEAL`：印章 - `DOCUMENT`：合同附件 - `USER`：用户相关文件 - `TEMP`：临时文件

TEMPLATEFLOWSEALDOCUMENTUSERTEMP

FileNamestring

文件名称，例如：`test.pdf`。文件名称长度限制为 100 个字符

响应参数

Response.Data

Response选填object

⌃子属性

RequestId选填string

请求 ID，用于追踪和调试

Error选填object

错误信息（成功时为空）

⌃子属性

Code选填string

错误码，通用错误码：`INVALID_REQUEST` / `UNAUTHORIZED` / `FORBIDDEN` / `NOT_FOUND` / `INTERNAL_ERROR`。各接口还可能返回 `VALIDATION.*`、`ENVELOPE.*`、`SIGNING.*`、`OPENAPI.*` 等业务错误码，详见各接口说明

Message选填string

错误描述

TaskId选填string

分片上传任务 ID，在上传分片接口中需传入此参数。TaskId 有效期为 24 小时

响应示例

{
  "Response": {
    "RequestId": "a6c43ab5-895d-4eb8-98b8-c64edb4e3331",
    "TaskId": "yD3J7UUckpeq3q6cUIGGOhSK1cZXTfsQ"
  }
}

上传文件上传文件分片