详情请到九云图官网了解一下。https://server.9yuntu.com/yuntu/resource/website/api.html
把 OFFICE / PDF / CAD 等文档转换成 PDF、HTML5(SVG)、长图片 等格式。在移动端缺少字库的情况下,也能保持字体和版式完全不变,支持添加水印、高清平滑缩放。转换生成的 HTML 不含任何脚本和外链。
文档转换GET
调用地址:http(s)://api.9yuntu.cn/execute/Convert
请求方式:GET
返回类型:JSON
API 调用:API 简单身份认证调用方法(APPCODE)展开API 签名认证调用方法(AppKey & AppSecret)
调试工具:去调试
请求参数(Headers)
请求参数(Query)
名称类型是否必须描述
docURLSTRING必选源文档URL,需进行URL编码。
outputTypeSTRING可选转换输出的格式,取值包括: "webview"(默认)- 返回长度为1的 URL 数组。数组成员指向一个可在浏览器中展现文档的URL,不支持下载; "html" - 返回长度为1的 URL 数组。数组成员指向一个包括所有页面内容的完整 HTML,不含任何脚本和外链,图片均以 svg 或 base64 形式内嵌,支持下载; "htmls" - 返回 URL 数组。文档的每个页面转换成一个独立的 HTML,不含任何脚本和外链,图片均以 svg 或 base64 形式内嵌,支持下载; "pdf" - 返回长度为1的 URL 数组。数组成员指向转换成的PDF文件,支持下载; "longimage" - 返回长度为1的 URL 数组。数组成员指向转换成的长图片,支持下载; "images" - 返回 URL 数组。文档的每个页面转换成一个单独的图片,支持下载; "svgs" - 返回 URL 数组。文档的每个页面转换成一个单独的 SVG 文件,支持下载。
titleSTRING可选在浏览器标题栏上显示的标题,默认是文件名称。需进行URI编码。
watermarkSTRING可选文档水印。可以是一段文字,也可以是图片URL。需进行URI编码。
请求参数(Body)
请求示例
curl
Java
C#
PHP
Python
ObjectC
curl -i -k --get --include‘https://api.9yuntu.cn/execute/Convert?docURL=http%253A%252F%252Foss.9yuntu.cn%252Fresources%252Fapi%252F%25E4%25B9%259D%25E4%25BA%2591%25E5%259B%25BEAPI%25E4%25BD%25BF%25E7%2594%25A8%25E8%25AF%25B4%25E6%2598%258E.docx&outputType=webview&title=%25e4%25b9%259d%25e4%25ba%2591%25e5%259b%25be&watermark=watermark‘-H‘Authorization:APPCODE 你自己的AppCode‘
正常返回示例
{"retCode":1,"retMsg":"文档正在处理中,请使用 QueryStatus 轮询转换结果。","docID":"xxxxxxxxxxxxx","outputType":"html","docStatusPage":"http://server.9yuntu.cn/execute/DocStatusPage?token=xxxxxxxxx"}
失败返回示例
{"retCode":2,:‘"retMsg":"文档转换失败!"}
错误码定义
错误码错误信息描述
2文档转换失败!文档转换不成功。
产品亮点
【1】目标格式支持 SVG,在移动端缺少字库的情况下,仍然可以完美还原绝大多数字体; 【2】可生成不含任何外链的 HTML5,展现时不必依赖九云图服务器; 【3】提供分页加载,适合超大文档展现; 【4】性能高度优化,可做到实时响应。
产品说明
当前,针对文档的 WEB 展现,特别是在移动端 WEB 展现,缺少成熟通用的技术方案。一些应用不得不采取变通的办法,比如阿里钉钉把文档页转成了图片、QQ 邮箱丢失字体轮廓特征、微信则要下载后通过第三方 APP 进行展现。
九云图经过长期技术积累和优化,较好地解决了这一问题,可以把各类文档转换成包含 SVG 的 HTML5 格式,为开发者提供如下服务:1、文档转换,可返回:(1)长度为 1 的 URL 数组 (指向完整的文档 PDF\HTML\长图片等,不包含任何脚本和外链,图片均以 svg 或 base64 形式内嵌);(2)长度为文档总页数的