信封签署 (eSign)接口列表创建文件转换任务

创建文件转换任务

POST/openapi/v1/files/convert-tasks

将非 PDF 文件（xlsx / docx / html 等）异步转换为 PDF。

使用流程：

  1. 调用上传文件拿到源文件 FileId
  2. 调用本接口提交转换任务，得到 TaskId
  3. 轮询查询文件转换任务直到 TaskStatus=success，取 ConvertedFileId
  4. 将 ConvertedFileId 用于快速发起信封的 Documents[].FileId

支持源格式：doc / docx / xls / xlsx / html / jpg / jpeg / png / bmp / txt

不支持：pdf（已是目标格式，直接使用即可）

转换耗时通常 2~10 秒，建议每 1~2 秒轮询一次。

请求参数

Header 参数
Authorization必填string
Bearer <access_token>
X-Operator-User-Id选填string
操作用户 ID。授权码模式下无需传（自动使用授权用户）；客户端凭据模式下可选，不填时使用系统用户 ID。
Body 请求体
application/json
FileId必填string
源文件 ID（必填），由 UploadFile 接口返回。源文件类型须为 doc / docx / xls / xlsx / html / jpg / jpeg / png / bmp / txt 之一

请求示例

{
  "FileId": "SGf1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6"
}

响应参数

Response.Data
TaskId选填string
转换任务 ID，客户端通过 QueryFileConvertTasks 轮询状态

响应示例

{
  "Response": {
    "RequestId": "req-abc123",
    "Error": null,
    "Data": {
      "TaskId": "20260709175117139808"
    }
  }
}

错误码

错误码说明
INVALID_REQUEST请求参数错误（FileId 为空、源文件已是 PDF、源文件类型不在支持列表内、FileId 不属于当前空间等）
OPENAPI.OPERATOR_USER_NOT_FOUND传入的 X-Operator-User-Id 不是该空间的成员
INTERNAL_ERROR服务内部错误（上游转换服务不可用等）
上传文件批量查询文件转换任务