上传文件

POST/

以二进制流方式上传文件，获取 FileId 供后续合同创建等操作使用。

支持通过 multipart/form-data 提交文件
上传成功后返回 FileId

请求参数

Header 参数

Authorization必填string

Bearer <access_token>

X-TC-Action必填string

接口名称，固定值 `CreateUploadFile`

X-TC-Timestamp必填string

当前 UNIX 时间戳（秒），例如 `1605024000`

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` — 临时数据

FileNamestring

文件名称，例如 `test.pdf`

Filefile

上传的文件（二进制流）

响应参数

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

错误描述

FileId选填string

上传后的文件 ID，可用于发起合同或进行其他操作

响应示例

{
  "Response": {
    "RequestId": "d9892984-589a-461d-a5f5-0d6a9577b63b",
    "FileId": "yD3J7UUckpxdeq66UIGGOhyp7CSx3NCG"
  }
}

调用方式创建文件分片上传任务