如何利用 onlyoffice 实现文档格式转换

​

目录

前言

正文

启动 onlyoffice 服务

API 接口介绍

转换列表

请求示例

结尾

前言

日常生活和工作中，文档格式转换应该是很常见的需求。面对这样的需求，我们技术男有没有属于自己的好方法呢？答案是有的，它就是 onlyoffice，今天就来介绍如何利用 onlyoffice 实现文档格式转换。

正文

启动 onlyoffice 服务

首先，我们以容器的方式启动一个 onlyoffice 服务，服务端口映射 9080。

服务地址：

http://127.0.0.1:9080/ConvertService.ashx

API 接口介绍

官方的 onlyoffice 版本在 4.2 之前使用的请求是 Get 类型，之后的版本使用的请求类型是 Post，这一点需要我们特别注意。下面的表格是关于格式转换 API 参数的详细介绍。

转换列表

下面是文本文档文件格式可以转换成其他格式的列表，第一列是源格式，从第二列到最后一列是可以转换成的其他格式，其中深色圆点表示支持，浅色圆点表示不支持。

下面是电子表格文件格式可以转换成其他格式的列表，第一列是源格式，从第二列到最后一列是可以转换成的其他格式，其中深色圆点表示支持，浅色圆点表示不支持。

下面是演示文稿格式可以转换成其他格式的列表，第一列是源格式，从第二列到最后一列是可以转换成的其他格式，其中深色圆点表示支持，浅色圆点表示不支持。

请求示例

接下来介绍一个把 docx 格式的文件转成 pdf 格式文件的请求示例：

{
    "async": false,
    "filetype": "docx",
    "key": "Khirz6zTPdfd7",
    "outputtype": "pdf",
    "title": "test.docx",
    "url": "https://example.com/url-to-example-document.docx"
}

返回结果：

<?xml version="1.0" encoding="utf-8"?>
<FileResult>
    <FileUrl>http://101.200.154.81:9080/cache/files/conv_Kheirdze1d6zdT3dePedfd78_pdf/output.pdf/test.pdf?md5=RlFbt79mXSUBieoAbPrylw&amp;expires=1644924337&amp;disposition=attachment&amp;ooname=output.pdf</FileUrl>
    <Percent>100</Percent>
    <EndConvert>True</EndConvert>
</FileResult>

结尾

好了，如何利用 onlyoffice 实现文档格式转换的方法就介绍完了，是不是很简单。需要注意的是所有的转换请求参数都是 JSON 格式，但是返回结果是 XML 格式，这一点我们需要特别注意，避免解析失败。

参考链接：api.onlyoffice.com/editors/con…

作者简介：😄大家好，我是 Data-Mining（liuzhen007），是一位典型的音视频技术爱好者，前后就职于传统广电巨头和音视频互联网公司，具有丰富的音视频直播和点播相关经验，对 WebRTC、FFmpeg 和 Electron 有非常深入的了解，😄公众号：玩转音视频。同时也是 CSDN 博客专家、华为云享专家（共创编辑）、InfoQ 签约作者，欢迎关注我分享更多干货！😄

​