文档拆分
💡 调用API,需要认证。认证参考【接口认证】
POST {apiPrefix}/split
提交文档拆分任务
- 任务添加失败,同步返回失败原因
- 任务添加成功,同步返回任务ID。第三方可以配置任务回调通知获取任务状态。
请求体:
Content-Type为application/json
| 参数名 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| fileUrl | string | 文件下载链接 | 是 |
| filename | string | 包含后缀的文件名(支持文字(doc,docx,wps)) | 是 |
| tokenType | string | 三方token类型,值为cookie或者header | 否 |
| tokenValue | string | 三方token值,zOffice下载文件或回调通知时回传 | 否 |
| callback | string | 回调地址。任务结束后zOffice回调通知状态 | 是 |
| type | string | 拆分类型,枚举: WORDHEADING: 根据标题拆分,SECTBREAK: 根据分节符拆分,TEXT:根据关键字拆分 | 是 |
| keyword | string | type为TEXT时必填,根据该文字拆分文档(该关键字指的是标题里的文字,所包含的标题不分等级) | 否 |
- tokenType/tokenValue/callback说明见本文档【通用字段说明】
- 文字文件大小不能超过300m。
正常返回:
{
"taskId": "6f6598c8-c87e-420b-b6c4-6f1b187201dc",
"code": "Ok",
"detail": {
"taskStatus": "IN_QUEUE"
}
}
错误返回:
{
"taskId": "695fbf6e-90d2-42ba-83d5-00e81e5e366e",
"code": "TaskQueueCongestion",
"detail": {
"taskStatus": "FAIL"
}
}