API 月度更新汇总：ONLYOFFICE 协作空间文档

2025 年 8 月，ONLYOFFICE 协作空间与文档 API 迎来全新升级，引入更多集成应用与开发工具。无论您是要搭建文档工作流、编写自定义插件，还是把 ONLYOFFICE 接入现有技术栈，本次更新都会为您提供省时高效的方案。

关于 ONLYOFFICE

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

ONLYOFFICE 文档提供文本文档、电子表格、幻灯片、表单和 PDF 编辑器，高度兼容微软 Office 格式，并提供数百种格式化和样式工具，以及多种协作功能，包括实时和段落锁定两种共同编辑模式、评论和审阅、内置聊天、版本历史等。该套件可在 Windows、Linux、Android 和 iOS上使用，包括网页、电脑桌面和手机/平板等移动设备。

ONLYOFFICE 协作空间在文档编辑器的基础上，还提供了一个基于房间的文档协作环境，旨在提升办公文档和其他内容的协作效率，让用户能够与同事、客户、合作伙伴、承包商、赞助商等多方人员顺畅协作。设置灵活的访问权限和用户角色设置，可支持用户对整个或单独房间的访问权限调整。

如果您需要将他们集成至您自有的商业软件和服务器，可以选择开发者版本，还支持自定义品牌选项、连接外部服务和存储等。

协作空间：Backend REST API 集成示例 

协作空间 API 此次更新包括了完整的集成示例，这些不是零散的代码片段，而是可立即使用的完整解决方案，覆盖真实业务场景。

Trello 集成示例

您现在可以轻松实现协作空间与 Trello 看板之间的双向集成​：

• 双向用户同步：自动在协作空间和 Trello 看板之间同步用户，无需手动邀请，确保团队跨平台进度一致。将协作空间用户加入 Trello / 将 Trello 用户同步到协作空间
• 资产迁移：Trello 卡片附件一键导入协作空间房间。简化项目交接，集中管理文档。 
• 项目结构镜像：根据 Trello 看板名称创建同名协作空间房间。保持项目结构统一。

以下为代码示例：

import requests# ONLYOFFICE 协作空间配置ONLYOFFICE_API_HOST = "your-docspace.onlyoffice.com"ONLYOFFICE_API_KEY = "your_onlyoffice_api_key"# Trello 配置TRELLO_API_KEY = "your_trello_api_key"TRELLO_TOKEN = "your_trello_token"TRELLO_BOARD_ID = "your_board_id"ONLYOFFICE_HEADERS = {"Authorization": f"Bearer {ONLYOFFICE_API_KEY}","Content-Type": "application/json","Accept": "application/json"}# 第 1 步：获取 Trello 看板名称def get_trello_board_name(board_id):url = f"https://api.trello.com/1/boards/{board_id}"params = {"key": TRELLO_API_KEY, "token": TRELLO_TOKEN}response = requests.get(url, params=params)if response.status_code == 200:return response.json()["name"]else:print(f"Trello board fetch error: {response.status_code}")return None# 第 2 步：用看板名称创建协作空间房间def create_docspace_room(room_title):url = f"https://{ONLYOFFICE_API_HOST}/api/2.0/files/rooms"payload = {"title": room_title,"roomType": 2,  # 协作房间"private": True}response = requests.post(url, headers=ONLYOFFICE_HEADERS, json=payload)if response.status_code == 200:print(f"Room created: {room_title}")return response.json()else:print(f"DocSpace room creation error: {response.status_code}, {response.text}")return None# 运行集成if __name__ == "__main__":board_name = get_trello_board_name(TRELLO_BOARD_ID)if board_name:create_docspace_room(board_name)

云存储集成 

• Dropbox 连接：最新 Dropbox 集成支持双向工作流：既可通过预签名 URL 导出协作空间文件，用于归档或备份，也能将文件直接导入指定房间，实现集中管理。
• 文件夹共享自动化：自动把 Dropbox 文件夹共享给协作空间用户或组员，实现跨平台无缝协作。

Notion 与 Asana 工作流

• Notion 用户同步：Notion 工作区同步到协作空间, 确保文档生态权限一致。
• Asana 项目自动化：根据 Asana 项目生成协作空间房间结构，每个任务都会自动对应一个文件夹，实现项目管理与文档协作的精准同步。
• 基于任务的邀请：自动邀请 Asana 任务负责人至对应协作空间房间，省去手动进行权限管理的麻烦。 

协作空间：升级版插件 SDK

插件 SDK 将迎来更新，新增基础与进阶示例，全面加速插件开发。

进阶插件示例

• 文件扩展名过滤插件：通过简洁的模态窗口，按文件类型对房间内容进行上下文级过滤，大量文档也能一目了然。
• 模态对话框插件：示范如何调用后端 API，在工具栏集成自定义按钮，直接在界面内按用户设定参数创建新文档。
• 设置插件 UI：为管理员提供专属配置界面，可对插件行为进行精细控制。

基础组件示例

全新基础示例涵盖常用 UI 组件：

• API 插件：正确连接平台 API 的范例。
• Box 组件：布局与间距配置示例。
• Button 组件：交互元素完整实施。
• ComboBox 组件：下拉选择界面。
• Text 组件：字体与样式设置。
• ToggleButton 组件：二元状态控制。

这些示例构成复杂插件所需的基石，并附带清晰的实施模式，可直接使用。

文档 API 新功能：自定义

新增的  suggestFeature 参数让您可以精细控制编辑器界面最新元素。

const config = {editorConfig: {customization: {
...
suggestFeature: true,

该参数决定文件标签页中“建议功能”菜单按钮是否可见。若部署在无需收集功能建议的内部环境中，可设为 false；若想持续让用户参与产品迭代，则可以设置为 true。

文档：全新 Office API 示例

为满足多元场景，ONLYOFFICE 新增了多个实用文档创建示例：

• 连续编号：在首列自动生成序号，提升表格导航与行引用效率。
• 格式化表格：创建表格时自动加边框、美化表头、对齐单元格文本，适用于报告、数据库导出或专业模板。
• 带筛选的电子表格：生成含交互式标题筛选器的电子表格，轻松排序与过滤数据，浏览分析更流畅。
• 含日期与公司名的页脚：自动在页脚左侧插入当前日期、右侧插入公司名称，备忘录、报告、信函及模板格式统一。
• 表格自动列宽：表格列宽随内容动态调整，布局紧凑美观。
• 项目符号任务列表：生成条理清晰的项目符号列表，便于罗列任务、步骤或需求。

这些模板示例可以在办公中，让文档创建变得更加轻松高效。

这次更新为开发者和企业用户带来了更加完善的集成方案和更强大的自定义能力。无论是与流行工具（如Trello、Dropbox、Notion和Asana）的集成，还是插件开发和文档处理，都变得更加简单高效。

这些更新使得ONLYOFFICE能够更好地适应各种业务场景，帮助企业构建安全高效的文档协作环境，为数字化协作提供标准化解决方案。

如果您想了解更多信息，可以点击此处查看全部 Office API 示例。