九云图文档转换API

九云图 API 按文档转换次数收费，所支持文档最大不能超过 500 兆，格式包括：
.dwg,.dwt, .dws, .dxf, .rtf, .doc, .docx, .dot, .dotx, .xls, .xlsx, .ppt, .pptx, .pps, .ppsx, .dps, .wps, .wpt, .et, 
.wpp, .png, .jpg, .gif, .tif, .bmp, .pdf, .txt, .java, .js, .c, .cpp, .html, .htm, .jsp, .css, .xml, .properties, .log。

API使用说明：
1.API接口：
CreateJobs：创建文档转换任务。
WaitJob：获取文档转换结果，只需调用一次即可，请求会等待转换结果直至返回成功或失败，等待时间随转换时间变化。
GetJob：获取文档转换结果，主动查询文档转换状态，推荐使用轮询查看转换结果。

2.接口调用
2.1创建转换任务（CreateJobs）
请求方式：POST
请求体（Body示例）：
{
 "tasks": {
  "ConvertFile": {
   "input": ["ImportFile"],
   "output_format": "pdf",
   "operation": "convert"
  },
  "ImportFile": {
   "url": "https://image2.9yuntu.cn/resources/api/%e4%b9%9d%e4%ba%91%e5%9b%beAPI%e4%bd%bf%e7%94%a8%e8%af%b4%e6%98%8e.docx",
   "operation": "import/url"
  },
  "ExportResult": {
   "input": ["ConvertFile"],
   "operation": "export/url"
  }
 },
 "tag": ""
}
请求体说明：
【tasks】上方的示例包括三项task：ImportFile，ConvertFile 和ExportResult。您可以根据需要重命名这些task，但是task名称中只能使用字母数字字符-和_。每个task都有一个operation，用于指定task需要执行的操作（例如：convert，import/url或export/url）。

【operation】您必须指定创建的task需要执行的操作：
"convert" —— 文档转换。
"import/url" —— 输入需转换的文档地址。
"export/url" —— 输出转换好的文档地址。

【input】本task依赖的task名称。可以将多个task名称作为数组提供。

【tag】标识转换任务的任意字符串。没有任何效果，可用于将其与您应用程序中的ID相关联。

【url】需转换的文档地址。

【output_format】转换后的文档类型：
"pdf" —— 转换成pdf文件，支持下载。
"protected-pdf" —— 转换成防复制的pdf文件，支持下载。
"docx" —— 转换成word文件，支持下载。
"pptx" —— 转换成ppt文件，支持下载。
"webview" —— 转换成在线文档，支持移动端预览，支持转发分享朋友圈，不支持下载。
"html(svg)" —— 转换成完整文档HTML，不包含任何脚本和外链，图片均以 svg 或 base64 形式内嵌，支持下载。【等等】
"html-array" —— 转换成分页HTML，支持下载。
"longimage"—— 转换成长条图片，支持下载。
"image-array"—— 转换成分页图片，支持下载。
"json" —— 输出json格式的数据，可用于自定义前端页面开发。
"svg-array" —— 转换成svg，支持下载。

2.2等待转换结果（WaitJob）
请求方式GET
请求参数（Path）：
jobId：调用CreateJobs接口获得jobId。

2.3主动查询转换结果（GetJob）
请求方式GET
请求参数（Path）：
jobId：调用CreateJobs接口获得jobId。

2.4响应参数：
status：
文档转换的状态：
"waiting" —— 文档转换任务创建成功，请调用WaitJob查看结果或者调用GetJob轮询查看结果。
"processing" —— 文档转换处理中，请调用WaitJob查看结果或者调用GetJob轮询查看结果。
"finished" —— 文档转换成功，转换结果位于tasks对象中。
"failed" —— 文档转换失败，请重试。