WPS官网开发者中心：开放平台与API接入

一、WPS开发者中心是什么？

WPS 开发者中心（open.wps.cn）是金山办公面向开发者推出的开放平台，提供包括文档处理、协作办公、AI 能力在内的一系列开放接口和 SDK，让企业和开发者能够将 WPS 的核心办公能力集成到自己的系统中。

1.1 开发者中心的核心定位

1.2 谁需要使用开发者中心？

二、开发者中心入口与注册

2.1 官方入口

2.2 开发者注册流程

① 访问 open.wps.cn → 点击"开发者注册"
 ↓
② 选择身份：个人开发者 / 企业开发者
 ↓
③ 填写基本信息（邮箱、手机号、企业名称等）
 ↓
④ 企业开发者需进行企业认证（营业执照上传）
 ↓
⑤ 创建应用 → 获取 AppID 和 AppSecret
 ↓
⑥ 开通所需 API 权限 → 开始接入开发

? 提示：开发者后台目前仅限企业用户访问。个人开发者需要通过企业身份或合作伙伴渠道接入。

三、WPS 开放平台核心能力

WPS 开放平台的能力体系可以分为五大板块：

3.1 365 OpenAPI

这是 WPS 开放能力的核心入口，所有开放接口以统一的 365 OpenAPI 对外提供。采用标准的 RESTful 设计风格，数据格式为 JSON。

技术规范：

• 接口协议：HTTPS
• 数据传输格式：JSON
• 鉴权方式：access_token（OAuth 2.0）
• SDK 支持：Java、Python、Node.js 等主流语言

? 核心概念：access_token 是接入开放平台的"钥匙"，对调用者身份进行鉴权——告知 WPS 当前是谁、以什么身份获取什么租户的数据。

3.2 WebOffice 文档处理

WebOffice 是 WPS 开放平台最受欢迎的能力之一，提供在线文档处理全场景能力。

支持的文件格式：

3.3 AI PPT 开放能力

WPS 2026 将 AI PPT 能力也开放给了开发者，包括：

3.4 协作中台

基于即时通讯场景提供的 SDK 与接口：

3.5 Web 组件与协作卡片

Web 组件：可用于开发各类 Web 插件，扩展或修改云文档等产品的前端能力。

协作卡片：构建消息卡片，支持可视化搭建工具。应用通过卡片可以：

• 发送通知消息
• 收集用户信息
• 与用户进行交互
• 让业务系统触手可及

四、API 接入实操指南

4.1 接入流程概览

第一步：创建应用 → 获取 AppID 和 AppSecret
 ↓
第二步：申请 API 权限 → 勾选需要的开放接口
 ↓
第三步：获取 access_token → 调用认证接口获取令牌
 ↓
第四步：调用 API → 使用 access_token 请求业务接口
 ↓
第五步：订阅事件（可选）→ 实时接收 WPS 事件通知
 ↓
第六步：上线发布 → 通过沙箱测试后正式上线

4.2 access_token 获取示例

POST https://open.wps.cn/api/auth/token
Content-Type: application/json

{
 "appId": "your_app_id",
 "appSecret": "your_app_secret"
}

返回示例：

{
 "code": 0,
 "message": "success",
 "data": {
  "access_token": "xxxxxxxxxxxxx",
  "expires_in": 7200
 }}

4.3 文档在线编辑接入示例

以下是一个简化的 JavaScript 接入示例，用于在网页中嵌入 WPS 在线编辑器：

// 初始化 WPS WebOfficeconst weboffice = new WPSWebOffice({ container: document.getElementById('editor'), token: 'your_access_token', fileId: 'file_123456', mode: 'edit', // 'edit' | 'view'
 config: {  toolbar: ['save', 'undo', 'redo', 'font', 'paragraph'],  menubar: true
 }
});// 打开文档weboffice.open();

4.4 事件订阅

应用可通过订阅事件实时获取 WPS 365 产品内的动作：

五、典型应用场景与案例

5.1 OA 系统文档集成

场景：企业 OA 系统中直接创建和编辑 Office 文档，无需上传下载。

用户操作流：
OA 系统 → 点击"新建公文" 
 → 调用 WPS API 创建 .docx 文档
 → 嵌入 WebOffice 在线编辑器
 → 编辑完成后保存到 OA 附件系统

5.2 教育平台文档批改

场景：在线教育平台接入 WPS 文档能力，实现学生作业在线提交和教师批改。

学生：在线编辑 → 提交作业
教师：在线预览 → 批注批改 → 评分
系统：自动格式转换 → 生成成绩单

5.3 电子合同平台

5.4 企业自建应用集成

企业可以将自研或外采的系统通过标准对接方式接入 WPS 365，并将应用上架到 WPS 协作工作台，用户可在工作台统一入口访问。

六、常见技术问题

6.1 API 调用限制

6.2 沙箱与测试环境

WPS 开放平台提供沙箱测试环境，开发者可在正式上线前完成：

• API 功能测试
• 异常处理验证
• 性能压力测试
• 兼容性验证

沙箱环境的数据和正式环境隔离，不会影响生产数据。

6.3 错误码参考

七、与 WPS 插件开发的区别

很多开发者会将"开放平台 API 接入"和"WPS 插件开发"混为一谈，它们其实是两条不同的开发路径。

? 简单区分：API 接入是让你的系统拥有 WPS 能力；插件开发是让 WPS 软件本身增加新功能。

八、常见问题解答（Q&A）

Q1：WPS开放平台的API是免费的吗？

回答：WPS 开放平台的基础 API 能力对企业认证用户免费开放（含通讯录、云文档基础接口等）。部分高级能力（如高频率调用、AI PPT 能力、企业级存储配额）可能需要购买对应的 WPS 365 企业版授权。建议先使用沙箱环境测试，再根据实际需求选择套餐。

Q2：个人开发者可以接入WPS开放平台吗？

回答：开发者后台目前主要面向企业用户。个人开发者可以通过以下方式接入：① 以合作伙伴身份通过企业渠道接入 ② 通过开放平台的公开 API（如 WebOffice）进行前端集成 ③ 在 WPS 应用市场注册为开发者并提交插件应用。对于纯前端集成的 WebOffice 能力，个人开发者也可以使用公开接入方式。

Q3：WebOffice支持哪些前端框架？

回答：WebOffice 是纯 JavaScript SDK，不依赖特定框架。可以在 Vue、React、Angular、jQuery 等任何前端框架中使用。只需在 HTML 页面中引入 SDK 脚本，绑定一个容器 DOM 元素即可。提供了 npm 包和 CDN 两种引入方式。

Q4：API调用的access_token过期了怎么办？

回答：access_token 有效期为 7200 秒（2 小时）。建议在服务端实现定时刷新逻辑：① 使用 refresh_token 自动刷新 ② 或提前 5 分钟检测 token 剩余时间并重新获取 ③ 在 API 调用返回 10001 错误码时触发重新获取。不建议在每次请求前都重新获取 token，这会增加不必要的网络开销。

Q5：开放平台和WPS 365是什么关系？

回答：WPS 开放平台是 WPS 365 产品的开放性基座。WPS 365 的所有产品能力（文档、协作、AI 等）以开放能力的形式注册到开放平台，供开发者使用。简单说，WPS 365 = 产品 + 服务，开放平台 = 这些能力的 API 出口。购买了 WPS 365 企业版的客户，可以直接使用开放平台的全部能力进行集成开发。

Q6：在线编辑和历史版本怎么配合使用？

回答：在接入 WebOffice 在线编辑时，可通过配置开启历史版本功能。开启后，每次保存都会生成一个版本快照。用户在前端可以查看版本列表、预览历史版本内容和恢复到任意版本。历史版本的保留时长与企业版配置相关（免费试用版 7 天，企业版 30~180 天）。

Q7：WPS开放平台支持哪些语言SDK？

回答：目前官方正式提供 SDK 支持的语言包括：Java（Spring Boot 集成）、Python、Node.js。其他语言可以通过直接调用 RESTful API 的方式接入（API 使用标准的 HTTP 协议 + JSON 格式，理论上任何支持 HTTP 请求的语言都可以接入）。官方文档中包含丰富的代码示例和错误码说明，帮助快速定位问题。

Q8：如何将开发的应用上架到WPS应用市场？

回答：在开发者后台完成应用开发后，可以提交上架申请：① 登录开发者后台 → 应用管理 → 提交审核 ② 金山办公审核团队会对应用进行安全审查和功能审核 ③ 审核通过后，应用即可在 WPS 应用市场（open.wps.cn/market）上架展示 ④ 企业用户可以直接在 WPS 365 协作工作台中搜索并使用你的应用。

九、总结

WPS 开发者中心和开放平台是金山办公构建办公软件生态的核心基础设施。无论是企业的 IT 系统集成、SaaS 平台的功能扩展，还是独立开发者的插件创新，开放平台都提供了完整、标准、文档完善的接入方案。