阐明
onlyoffice 提供文档转换服务,根本涵盖了简直所有常见文档之间的转换,能够看下 word 文档能转换成的文档格局就晓得其弱小
实现
转换接口
文档转换是通过接口来实现的,接口地址是https://documentserver/ConvertService.ashx
,documentserver 是 documentserver 的地址。这里列举几个常见的转换例子
- word 转 pdf
➜ curl --location --request POST 'http://47.113.219.133:9001/ConvertService.ashx' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"async": false,"filetype":"docx","key":"Khirz6zTPdfd7","outputtype":"pdf","title":"example.docx","url":"https://zhengjianfeng.cn/document/example.docx"}'
{
"fileUrl": "http://47.113.219.133:9001/cache/files/conv_Khirz6zTPdfd7_pdf/output.pdf/example.pdf?md5=iPboTbRhw7JVpcicXZhiZg&expires=1638502601&filename=example.pdf",
"percent": 100,
"endConvert": true
}
参数阐明
- async:指定转换是同步的还是异步的,如果是 false 那么转换会同步进行,转换实现后才会返回
- filetype:文档类型
- key:文档标识符
- outputtype:输入文档类型
- title:题目
- url:文档门路
另外在 header 中须要申明承受类型Accept: application/json
,不然默认返回的是 xml 格局的数据
响应阐明
- fileUrl:转换后文件下载门路
- percent:转换进度,如果 async 为 false 的话,这里永远都是 100
- endConvert:是否转换完结
如果不指定 Accept 默认返回的是 xml,须要将 fileUrl 中的
&aml;
变成 & 能力拜访,不然会报 403 谬误
参考文档
- 转换 API