九云图DocSDK API 文档使用说明


1. 版本历史

日期 版本号 作者 备注
2020.12.17 2.0 水水 API V2

2. 接口类说明

接口 说明
CreateJobs 创建文档转换任务。可选择前往https://login.docsdk.com设置回调地址,我们会向您设置的回调地址发送文档的最终转换结果,无需调用WaitJob和GetJob。
WaitJob 获取文档转换结果,只需调用一次即可,请求会等待转换结果直至返回成功或失败,等待时间随转换时间变化。
GetJob 获取文档转换结果,主动查询文档转换状态,推荐使用轮询查看转换结果。

3. 接口调用

3.1 创建转换任务(CreateJobs)

3.1.1 请求说明

请求方式:POST

请求URL:https://api.docsdk.com/v2/jobs

3.1.2 请求参数

参数
是否必填
数据类型 说明
tasks object 下方的示例包括三项task:ImportURLConvertFileExportResult。您可以根据需要重命名这些task,但是task名称中只能使用字母数字字符-_。每个task都有一个operation,用于指定task需要执行的操作(例如:convertimport/urlexport/url)。
operation string 您必须指定创建的task需要执行的操作:
"convert" —— 文档转换。
"import/url" —— 输入需转换的文档地址。
"export/url" —— 输出转换好的文档地址。
"zip/files" —— 支持输出压缩文件。
input string/array 输入您定义的task名称。可以将多个task名称作为数组提供。
tag string 标识转换任务的任意字符串。没有任何效果,可用于将其与您应用程序中的ID相关联。
docUrl string 需转换的文档地址。
outputType string 需生成的文档类型:
"pdf" —— 转换成pdf文件,支持下载。
"protected-pdf" —— 转换成防复制的pdf文件,支持下载。
"docx" —— 转换成word文件,支持下载。
"xlsx" —— 转换成excel文件,支持下载。
"pptx" —— 转换成ppt文件,支持下载。
"webview" —— 转换成在线文档,支持移动端预览,支持转发分享朋友圈,不支持下载。
"html" —— 转换成完整文档HTML,支持下载。
"h5ppt" —— 把PPT转换成在线播放的HTML5,支持动画特效。
"html5" —— 转换成完整文档HTML,不包含任何脚本和外链,图片均以 svg 或 base64 形式内嵌,支持下载。
"html-array" —— 转换成分页HTML,支持下载。
"long-image"—— 转换成长条图片,支持下载。
"image-array"—— 转换成分页图片,支持下载。
"json" —— 输出json格式的数据,可用于自定义前端页面开发。
"svg-array" —— 转换成svg,支持下载。
"epub" —— 转换成电子书,支持下载。
apiKey string 置于请求头中,用于鉴权。试用apiKey: Mwxenlfym9m9NyJyEpGj8aSCUjcXldGKwiRk。如若需要创建属于您自己的apiKey,也可前往https://login.docsdk.com自行创建。

请求示例:

3.1.3 响应参数

参数 是否必填 说明
id 此id即jobId,用于请求查看文档转换状态。
status 文档转换的状态:
"waiting" —— 文档转换任务创建成功,请调用WaitJob查看结果或者调用GetJob轮询查看结果。
"processing" —— 文档转换处理中,请调用WaitJob查看结果或者调用GetJob轮询查看结果。
"finished" —— 文档转换成功,转换结果位于tasks对象中。
"failed" —— 文档转换失败,请重试。

响应示例:

如若设置了回调地址,下方为回调地址接收到的参数示例:

 

3.2 等待转换结果(WaitJob)

3.2.1 请求说明

请求方式:GET

请求URL:https://api.docsdk.com/v2/jobs/ jobId /wait

3.2.2 请求参数

参数
是否必填
说明
jobId 调用CreateJobs接口获得jobId。
apiKey 置于请求头中,用于鉴权。试用apiKey: Mwxenlfym9m9NyJyEpGj8aSCUjcXldGKwiRk。如若需要创建属于您自己的apiKey,也可前往https://login.docsdk.com自行创建。

请求示例:

3.2.3 响应参数

参数 是否必填 说明
status 文档转换的状态:
"finished" —— 文档转换成功,转换结果位于tasks对象中。
"failed" —— 文档转换失败,请重试。

响应示例:

3.3 主动查询转换结果(GetJob)

3.3.1 请求说明

请求方式:GET

请求URL:https://api.docsdk.com/v2/jobs/ jobId

3.3.2 请求参数

参数
是否必填
说明
jobId 调用CreateJobs接口获得jobId。
apiKey 置于请求头中,用于鉴权。试用apiKey: Mwxenlfym9m9NyJyEpGj8aSCUjcXldGKwiRk。如若需要创建属于您自己的apiKey,也可前往https://login.docsdk.com自行创建。

请求示例:

3.3.3 响应参数

参数 是否必填 说明
status 文档转换的状态:
"waiting" —— 文档转换任务创建成功,请调用WaitJob查看结果或者调用GetJob轮询查看结果。
"processing" —— 文档转换处理中,请调用WaitJob查看结果或者调用GetJob轮询查看结果。
"finished" —— 文档转换成功,转换结果位于tasks对象中。
"failed" —— 文档转换失败,请重试。

响应示例:

 

API接口

https://api.docsdk.com/v2

示例请求

$ curl -X POST "https://api.docsdk.com/v2/jobs" \
       -H "Authorization: Bearer API_KEY" \
       -H "Content-type: application/json" \
       -d '
       
{
...
}
'

范例回应

HTTP/1.1 200 OK
Content-Type: application/json
       
{
  "data": {
    ...
  }
}