当前位置：首页 > news >正文

ONLYOFFICE 文档 API ：新的文档格式支持及配置方法

news 来源：原创 2025/5/7 8:50:43

在环境多样化、国际化的办公合作场景中，对文档格式的支持程度成为设备、系统互联的关键手段。ONLYOFFICE 文档 API 最近更新了文档格式支持，新增了对 Apple iWork 和 Hancom Office 格式的支持，为开发者和系统集成商提供了更广阔的选择和调用灵活性。

关于 ONLYOFFICE 文档

ONLYOFFICE 是一个开源项目，专注于高级和安全的文档处理和协作。全球超过 1500 万用户，是在线办公领域的创新者。

ONLYOFFICE 文档提供文本文档、电子表格、幻灯片、表单和 PDF 编辑器。ONLYOFFICE 文档高度兼容微软 Office 格式，并提供数百种格式化和样式工具，以及多种协作功能，包括实时和段落锁定两种共同编辑模式、评论和审阅、内置聊天和版本历史等。

该办公套件可以连接到多个云平台，如 WordPress、Seafile、Moodle、Nextcloud、Odoo、ownCloud、Confluence、Jira 等，并且包含由 ONLYOFFICE 或其官方合作伙伴提供的现成集成应用。另一种集成选项则是使用 WOPI 协议。

ONLYOFFICE 可以在任何平台上部署，包括 Windows、Linux、macOS、Android，也可以在任何设备上使用。在线、移动和桌面版本均使用同一引擎，确保离线和在线工作之间无缝切换。

下面我们一起了解近期 API 更新中增加的格式支持。

API 新增格式支持

文档 API 现在支持更多文件格式，提供更广泛的兼容性，确保用户在使用各种文件类型时获得流畅的体验。其中包括 Apple iWork 和 Hancom Office 格式：

🍏 Apple iWork

.pages
.key
.numbers

🌟 Hancom Office

.hwp
.hwpx

这些文档在韩国、日本和欧美等地区有常见应用，让您的应用服务更容易面向国际化用户。

如何通过 documentType 配置格式？

使用 ONLYOFFICE 文档 API 时，您可以通过 documentType 属性指定文档类型，并根据文件类型自动识别合适的打开组件。

示例：

const config = {documentType: "pages", // 或 "hwp", "numbers", 等type: "desktop",height: "100%",width: "100%",token: "<your-token>"
};const docEditor = new DocsAPI.DocEditor("placeholder", config);

注：自 v6.1 起，使用 text / spreadsheet / presentation 的配置方式已经被弃用，请使用 word / cell / slide 方案。

文档类型配置列表

documentType 值	支持格式后缀
word	.doc, .docx, .pages, .hwp, etc
cell	.xls, .xlsx, .numbers, etc
slide	.ppt, .key, etc
pdf	.pdf, .xps, .djvu, etc

为什么选择此配置？

做好格式配置，可以改善渲染效果，减少打开错误
选择合适的 documentType ，为应用程序提供更好的操作体验
便于后端统一处理文档类型

结语

借助 ONLYOFFICE 文档 API 新增格式支持，您可以轻松实现国际化文档处理需求，方便面向 iWork 和 Hancom 系列用户，最大化应用程序的应用场景和用户群体。