乐趣区

关于office:onlyoffice教程0x05文件转换

阐明

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
退出移动版