产品简介
概述
WPS365产品作为办公新质生产力平台,全面面向一站式AI办公场景,目的为帮助企业或组织提高生产力。WPS365由WPS Office、WPS AI企业版、WPS协作套件等组成,包含云文档、智能文档、多维表格、传统表格、智能表格、消息与会话、邮箱、待办、日历、会议、OFFICE客户端等业务域。点此详细了解WPS365
在企业或组织内部,除WPS 365以外,通常也会存在其他IT系统,如OA、CRM、ERP或组织内的各类行业专业化系统等。这些系统与WPS365共同担负起组织数字化运行的职责,因此通常需要相互融合、集成,才能为员工带来更好的日常使用体验,并更大程度推进企业或组织完成数字化转型。
WPS365应用即面向这一类场景,各个业务域均提供了丰富的服务端WPS 365 OpenAPI、客户端JSAPI、回调事件等,对其他IT系统提供WPS 365内业务的查询、操作、对接能力。
常用业务域
WPS365具有近20个业务域,以下为您介绍几个典型业务域与其开放的能力。
通讯录
即WPS365的账号体系,企业通讯录包括部门、用户、用户组等不同层级。在通讯录方面,WPS365提供了部门/用户的查询、创建、删除、更新、移动等丰富的管理能力,可实现WPS365 账号体系与企业现有账号系统同步、单点登录等场景。同时也提供部门/用户的变更事件,第三方系统可以订阅监听WPS365账号的状态变化。
~常用API列表
| API名称 | 说明 | 权限要求 | 请求路径 |
|---|---|---|---|
| 创建部门 | 在企业下创建新的部门 | 查询和管理通讯录信息(应用授权) | https://openapi.wps.cn/v7/depts/create |
| 创建用户 | 在某个部门下创建新用户 | 查询和管理通讯录信息(应用授权) | https://openapi.wps.cn/v7/users/create |
| 将用户加入到部门 | 将用户移动到某个部门下 | 查询和管理通讯录信息(应用授权) | https://openapi.wps.cn/v7/depts/{dept_id}/members/{user_id}/create |
| 查询部门下用户列表 | 查询某个部门下所有用户的信息 | 查询和管理通讯录信息(应用授权) 查询通讯录信息(应用授权) | https://openapi.wps.cn/v7/depts/{dept_id}/members |
云文档
即WPS365的在线文档管理能力,云端文档可存储在个人空间、团队空间下的不同文件夹。云文档开放了文件(夹)创建管理、文件上传下载、文件分享、文件权限管理等文件全生命周期管理的能力,企业可实现三方系统与云文档的对接。如将邮件系统中的附件自动转存到云文档中、OA系统中直接上传云文档中的文件等。
~常用API列表
| API名称 | 说明 | 权限要求 | 请求路径 |
|---|---|---|---|
| 新建驱动盘 | 即新建企业团队,团队文件存储在驱动盘中 | 管理驱动盘(应用授权) 管理驱动盘(用户授权) | https://openapi.wps.cn/v7/drives/create |
| 新建文件(夹) | 在某个驱动盘下新建文件或文件夹 | 查询和管理文件(应用授权) 查询和管理文件(用户授权) | https://openapi.wps.cn/v7/drives/{drive_id}/files/{parent_id}/create |
| 获取文件下载信息 | 获取文件的下载链接 | 查询和管理文件(应用授权) 查询文件(应用授权) 查询和管理文件(用户授权) 查询文件(用户授权) | https://openapi.wps.cn/v7/drives/{drive_id}/files/{file_id}/download |
| 请求文件上传信息 | 文件上传三部曲的首步 | 查询和管理文件(应用授权) 查询和管理文件(用户授权) | https://openapi.wps.cn/v7/drives/{drive_id}/files/{parent_id}/request_upload |
多维表格
即WPS365的结构化数据表能力。多维表格以数据表、字段、视图、记录组织数据,适合业务台账、信息收集与系统对接。开放了数据表/字段/视图/记录的增删改查、仪表盘、内容权限与 Webhook 等能力,企业可将 CRM、OA 中的业务数据同步到多维表格,或从多维表格读取记录回写业务系统。
首次读写见 多维表格快速开始。
~常用API列表
| API名称 | 说明 | 权限要求 | 请求路径 |
|---|---|---|---|
| 创建数据表 | 在多维表格文件中创建数据表 | 查询和管理多维表格(应用授权) 查询和管理多维表格(用户授权) | https://openapi.wps.cn/v7/coop/dbsheet/{file_id}/sheets/create |
| 创建记录 | 向指定数据表写入一条或多条记录 | 查询和管理多维表格(应用授权) 查询和管理多维表格(用户授权) | https://openapi.wps.cn/v7/coop/dbsheet/{file_id}/sheets/{sheet_id}/records/create |
| 列举记录 | 查询指定数据表中的记录 | 查询和管理多维表格(应用授权) 查询多维表格(应用授权) 查询和管理多维表格(用户授权) 查询多维表格(用户授权) | https://openapi.wps.cn/v7/coop/dbsheet/{file_id}/sheets/{sheet_id}/records |
| 列出视图 | 查询指定数据表下的视图列表 | 查询和管理多维表格(应用授权) 查询多维表格(应用授权) 查询和管理多维表格(用户授权) 查询多维表格(用户授权) | https://openapi.wps.cn/v7/dbsheet/{file_id}/sheets/{sheet_id}/views |
传统表格
即兼容 Excel 的在线电子表格能力。传统表格开放了工作表管理、单元格选区读写、筛选、数据校验、条件格式、区域权限等能力,企业可在 OA、报表系统中直接读写云端表格内容。
首次读写见 传统表格快速开始。
~常用API列表
| API名称 | 说明 | 权限要求 | 请求路径 |
|---|---|---|---|
| 获取工作表 | 获取传统表格文件中的工作表列表 | 查询和管理传统表格(应用授权) 查询传统表格(应用授权) 查询和管理传统表格(用户授权) 查询传统表格(用户授权) | https://openapi.wps.cn/v7/sheets/{file_id}/worksheets |
| 创建工作表 | 在传统表格文件中创建工作表 | 查询和管理传统表格(应用授权) 查询和管理传统表格(用户授权) | https://openapi.wps.cn/v7/sheets/{file_id}/worksheets |
| 获取单元格选区数据 | 读取工作表中一块矩形区域的单元格 | 查询和管理传统表格(应用授权) 查询传统表格(应用授权) 查询和管理传统表格(用户授权) 查询传统表格(用户授权) | https://openapi.wps.cn/v7/sheets/{file_id}/worksheets/{worksheet_id}/range_data |
| 更新单元格选区数据 | 按选区更新单元格公式、格式、图片或合并 | 查询和管理传统表格(应用授权) 查询和管理传统表格(用户授权) | https://openapi.wps.cn/v7/sheets/{file_id}/worksheets/{worksheet_id}/range_data/batch_update |
智能表格
即WPS365的智能表格能力。智能表格提供与传统表格相近的工作表与单元格 OpenAPI,并支持直接创建智能表格文件,适合轻量表格协作与数据填报。
首次读写见 智能表格快速开始。
~常用API列表
| API名称 | 说明 | 权限要求 | 请求路径 |
|---|---|---|---|
| 创建智能表格 | 在云文档中创建智能表格文件 | 查询和管理智能表格(应用授权) 查询和管理智能表格(用户授权) | https://openapi.wps.cn/v7/airsheet/files |
| 创建工作表 | 在智能表格文件中创建工作表 | 查询和管理智能表格(应用授权) 查询和管理智能表格(用户授权) | https://openapi.wps.cn/v7/airsheet/{file_id}/worksheets |
| 获取区域数据 | 读取工作表中一块矩形区域的单元格 | 查询智能表格(应用授权) 查询智能表格(用户授权) 查询和管理智能表格(应用授权) 查询和管理智能表格(用户授权) | https://openapi.wps.cn/v7/airsheet/{file_id}/worksheets/{worksheet_id}/range_data |
| 创建数据 | 在工作表末尾新增一行并写入单元格 | 查询和管理智能表格(应用授权) 查询和管理智能表格(用户授权) | https://openapi.wps.cn/v7/airsheet/{file_id}/worksheets/{worksheet_id}/rows |
何时选哪类表
三类表格的 OpenAPI 不能互换 file_id、路径前缀和权限 scope。按下表选型后再进入对应快速开始。
| 产品 | 云文档类型 / 扩展名 | 权限 | 适合什么 |
|---|---|---|---|
| 多维表格 | 类型 db,扩展名 .dbt | kso.dbsheet.read / kso.dbsheet.readwrite | 台账、记录增删改查、视图、Webhook |
| 传统表格 | 类型 et(扩展名可能是 .xlsx / .et 等,以类型为准) | kso.sheets.read / kso.sheets.readwrite | Excel 兼容的单元格、格式、筛选 |
| 智能表格 | 后缀 ksheet | kso.airsheet.read / kso.airsheet.readwrite | 可用 API 创建文件的轻量表格协作、填报 |
- 浏览器分享地址
/l/{link_id}里的是 link_id,不能直接当作{file_id}。 - 多维表格里路径参数
sheet_id指数据表;传统表格、智能表格里worksheet_id指工作表。 - 快速开始:多维表格、传统表格、智能表格。
消息与会话
即基于WPS协作提供的即时消息,WPS365开放了群聊管理、发送消息、查询消息等能力,企业可通过这一系列能力帮助各类业务建立更及时、高效的沟通渠道,如在工单系统中,就可以对接群聊管理接口,基于工单自动化建立相关人群聊。同时,WPS协作也提供了机器人的能力,可用于系统自动向用户推送消息,如邮件提醒、部门公告等。
~常用API列表
| API名称 | 说明 | 权限要求 | 请求路径 |
| 发送消息 | 应用通过WPS协作给用户或会话发送消息 | 查询和管理会话消息(应用授权) | https://openapi.wps.cn/v7/messages/create |
| 创建会话 | 创建单聊或群聊会话 | 查询和管理会话(应用授权) | https://openapi.wps.cn/v7/chats/create |
| 批量添加群成员 | 在某个群聊中添加新成员 | 查询和管理会话(应用授权) | https://openapi.wps.cn/v7/chats/%7Bchat_id%7D/members/batch_create |
| 创建部门群 | 基于某个部门创建群,群成员根据部门自动更新 | 读写部门群(应用授权) | https://openapi.wps.cn/v7/chats/create_dept_chat |
工作台
即基于WPS协作提供的工作台管理能力,企业可将内部系统上架到WPS协作工作台,将工作台作为办公门户。员工在日常办公时,只需要在工作台内即可打开所有三方系统,更为高效。
客户端
基于WPS Office客户端、WPS 协作客户端提供的JSAPI与前端能力,如为WPS Office嵌入加载项,或为文字、演示、表格等组件增加宏事件。
使用方式
通过开发者后台即可创建应用,以应用身份调用WPS365开放的各类接口
详细使用方式可见自建应用概述