ONLYOFFICE 协作空间与文档 API更新-2025.09.17

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

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

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

Trello 集成示例

双向用户同步：自动在协作空间和 Trello 看板之间同步用户，无需手动邀请，确保团队跨平台进度一致。将协作空间用户加入 Trello / 将 Trello 用户同步到协作空间

资产迁移：Trello 卡片附件一键导入协作空间房间。简化项目交接，集中管理文档。

项目结构镜像：根据 Trello 看板名称创建同名协作空间房间。保持项目结构统一。以下为代码示例：

import requests# ONLYOFFICE DocSpace configurationONLYOFFICE_API_HOST = "your-docspace.onlyoffice.com"ONLYOFFICE_API_KEY = "your_onlyoffice_api_key"# Trello configurationTRELLO_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"}# Step 1: Get Trello board namedef 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# Step 2: Create a DocSpace room with board namedef create_docspace_room(room_title): url = f"https://{ONLYOFFICE_API_HOST}/api/2.0/files/rooms" payload = {"title": room_title,"roomType": 2, # Collaboration room"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# Run integrationif __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 新增了多个实用文档创建示例：

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

查看全部 Office API 示例

福利推荐-软件获取方法

豆豆容器市场专注提供优质Docker应用服务，集成一键式容器安装功能，助力用户快速部署OnlyOffice、协作空间、Jitsi-Meet会议系统、内网域名系统、Nextcloud、可道云等办公应用。平台新增IPv6内网直连技术，搭配自动化SSL证书配置及智能域名解析功能，为家庭云服务提供完整技术方案，简化私有云搭建与运维流程，轻松实现高效云端协作管理。

本容器市场针对各种nas设备优化,全线安装服务支持飞牛、群晖、威联通、麒麟、ubuntu、centors等各种linux系统。

独家发布飞牛云豆豆编辑器,支持直接编辑飞牛磁盘上的文档。

onlyoffice协作空间除了提供常规的标准版/企业版/开发版,还特别针对机器配置较低的用户,独家提供协作空间迷你版(仅需5g内存即可正常运行,官方其他版本需要16g内存)。

onlyoffice已经支持ARM和x86双模式安装,其他软件同步支持中。

地址: https://ds.sendtokindle.net.cn/