郑剑峰的个人博客

说明

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