九云图文档转换API

商品详情

商品亮点

• 除PDF、图片以外，还可以转换成 HTML、SVG、PPT、WORD 、图纸文件也可以处理。
• 手机里没有字库，九云图DocSDK却可以完美保持字体效果。
• 通过采用按需加载、矢量缩放等技术，提高了用户阅读体验。
• 可以对文档进行深度解析，精准分离出文字、图片、图形、表格，并以结构化 JSON 的形式输出解析结果。

商品说明

版本: V7.4.3	交付方式: API
适用于: 其他	上架日期: 2021-05-06

九云图 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" —— 文档转换失败，请重试。

API接口

• 创建文档转换任务CreateJobs
• 等待转换结果WaitJob
• 查询转换结果GetJob

创建文档转换任务CreateJobs

http(s)://pdf.apistore.huaweicloud.com/v2/jobs

POST

JSON

API调用方法

调试API 请求参数（Path）

无参数

请求参数（Headers）

无参数

请求参数（Query）

无参数

请求参数（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：ImportURL，ConvertFile 和ExportResult。您可以根据需要重命名这些task，但是task名称中只能使用字母数字字符-和_。每个task都有一个operation，用于指定task需要执行的操作（例如：convert，import/url或export/url）。 【operation】您必须指定创建的task需要执行的操作： "convert" —— 文档转换。 "import/url" —— 输入需转换的文档地址。 "export/url" —— 输出转换好的文档地址。 "zip/files" —— 支持输出压缩文件。 【input】输入您定义的task名称。可以将多个task名称作为数组提供。 【tag】标识转换任务的任意字符串。没有任何效果，可用于将其与您应用程序中的ID相关联。 【docUrl】需转换的文档地址。 【outputType】需生成的文档类型： "pdf" —— 转换成pdf文件，支持下载。 【apiKey】置于请求头中，用于鉴权。试用apiKey: Mwxenlfym9m9NyJyEpGj8aSCUjcXldGKwiRk。如若需要创建属于您自己的apiKey，也可前往https://login.docsdk.com自行创建。

正常返回示例

{ "data": { "code": "", "created_at": "2021-04-29T14:57:35.060", "ended_at": "", "id": "EuFVioWvXKm8pz9EW3H4RS", "links": {}, "message": "", "percent": 0, "started_at": "", "status": "processing", "tag": "", "tasks": [ { "code": "", "copy_of_task_id": "", "created_at": "2021-04-29T14:57:35.060", "credits": "", "depends_on_task_ids": [ "GkA9VgfZ9qUd65s4D5WvUe" ], "ended_at": "", "engine": "", "engine_version": "", "footerImage": "", "headerImage": "", "host_name": "", "id": "EwthLd3fgIlHNw9LdlWxAl", "input": [ "ImportFile" ], "job_id": "EuFVioWvXKm8pz9EW3H4RS", "links": {}, "message": "", "name": "ConvertFile", "operation": "convert", "output_disposition": "", "output_format": "pdf", "pageCount": 0, "pages": "", "percent": 0, "priority": 0, "protected_mode": "", "qrcode_position": "", "qrcode_url": "", "result": {}, "retry_of_task_id": "", "started_at": "", "status": "waiting", "storage": "", "timeout": -1, "token": "", "url": "", "user_id": 0, "water_image": "", "water_opacity": "", "water_text": "" }, { "code": "", "copy_of_task_id": "", "created_at": "2021-04-29T14:57:35.060", "credits": "", "depends_on_task_ids": [], "ended_at": "", "engine": "", "engine_version": "", "footerImage": "", "headerImage": "", "host_name": "", "id": "GkA9VgfZ9qUd65s4D5WvUe", "input": [], "job_id": "EuFVioWvXKm8pz9EW3H4RS", "links": {}, "message": "", "name": "ImportFile", "operation": "import/url", "output_disposition": "", "output_format": "", "pageCount": 0, "pages": "", "percent": 0, "priority": 0, "protected_mode": "", "qrcode_position": "", "qrcode_url": "", "result": {}, "retry_of_task_id": "", "started_at": "", "status": "waiting", "storage": "", "timeout": -1, "token": "", "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", "user_id": 0, "water_image": "", "water_opacity": "", "water_text": "" }, { "code": "", "copy_of_task_id": "", "created_at": "2021-04-29T14:57:35.060", "credits": "", "depends_on_task_ids": [ "EwthLd3fgIlHNw9LdlWxAl" ], "ended_at": "", "engine": "", "engine_version": "", "footerImage": "", "headerImage": "", "host_name": "", "id": "BN52KJtqBQJ7ColC86uP3h", "input": [ "ConvertFile" ], "job_id": "EuFVioWvXKm8pz9EW3H4RS", "links": {}, "message": "", "name": "ExportResult", "operation": "export/url", "output_disposition": "", "output_format": "", "pageCount": 0, "pages": "", "percent": 0, "priority": 0, "protected_mode": "", "qrcode_position": "", "qrcode_url": "", "result": {}, "retry_of_task_id": "", "started_at": "", "status": "waiting", "storage": "", "timeout": -1, "token": "", "url": "", "user_id": 0, "water_image": "", "water_opacity": "", "water_text": "" } ], "token": "" } }

失败返回示例

无参数

商品定价

规格	计费项	计费模式	目录价
【文档转PDF】	10次	按次套餐包	1.00元/10次
1000次	按次套餐包	30.00元/1000次
15000	按次套餐包	300.00元/15000次
20000	按次套餐包	375.00元/20000次
【文档转分页HTML】	10次	按次套餐包	50.00元/10次
1000次	按次套餐包	2,500.00元/1000次
15000	按次套餐包	25,000.00元/15000次
20000	按次套餐包	31,250.00元/20000次
【文档转JSON(文档解析)】	10次	按次套餐包	50.00元/10次
1000次	按次套餐包	2,500.00元/1000次
15000	按次套餐包	25,000.00元/15000次
20000	按次套餐包	31,250.00元/20000次
【文档转SVG】	10次	按次套餐包	10.00元/10次
1000次	按次套餐包	500.00元/1000次
15000	按次套餐包	5,000.00元/15000次
20000	按次套餐包	6,250.00元/20000次
【文档转PDF(内容防复制)】	10次	按次套餐包	10.00元/10次
1000次	按次套餐包	500.00元/1000次
15000	按次套餐包	5,000.00元/15000次
20000	按次套餐包	6,250.00元/20000次
【文档转Word】	10次	按次套餐包	100.00元/10次
1000次	按次套餐包	5,000.00元/1000次
15000	按次套餐包	50,000.00元/15000次
20000	按次套餐包	62,500.00元/20000次
【文档转长条图片】	10次	按次套餐包	10.00元/10次
1000次	按次套餐包	500.00元/1000次
15000	按次套餐包	5,000.00元/15000次
20000	按次套餐包	6,250.00元/20000次
【文档转分页图片】	10次	按次套餐包	1.00元/10次
1000次	按次套餐包	50.00元/1000次
15000	按次套餐包	500.00元/15000次
20000	按次套餐包	625.00元/20000次
【文档转HTML】	10次	按次套餐包	50.00元/10次
1000次	按次套餐包	2,500.00元/1000次
15000	按次套餐包	25,000.00元/15000次
20000	按次套餐包	31,250.00元/20000次
【文档转PPT】	10次	按次套餐包	50.00元/10次
1000次	按次套餐包	2,500.00元/1000次
15000	按次套餐包	25,000.00元/15000次
20000	按次套餐包	31,250.00元/20000次
【文档转在线预览H5】	10次	按次套餐包	2.00元/10次
1000次	按次套餐包	60.00元/1000次
15000	按次套餐包	600.00元/15000次
20000	按次套餐包	700.00元/20000次

用户案例

暂无，请等待更新

评价与问答

用户评价 综合评分：

暂无，请等待更新

展开更多 商品问答 有疑问快问商家吧~ 我要提问

• 长条图片和分页图片有什么区别

  2021-09-18 09:26

  l*****g

  长条图片就是一张图片，分页图片就是每页一张图片，返回多个url

  2021-09-18 17:08

  服务商

  点击查看全部2个回答

展开更多

服务支持

使用指南 九云图文档格式转换API使用说明.docx 下载 平台支持范围

售后服务时间：7 * 24小时
售后服务内容：九云图转换服务中产生的使用问题和产品异常
服务热线：13918951761、18721988075、8621-60345662
服务邮箱：support@9yuntu.com

商品服务协议

订购此商品即为您同意《商品服务协议》

联系方式

电话: 13918951761

邮箱: support@9yuntu.com