老板非要在这个项目里用 WPS 的多维表格 作为数据库,没办法,只能去研究。第一步就是读取 WPS 多维表格,既然要读取,肯定得用到 API,那就先看文档。后来我调通之后发现,它和飞书多维表格简直一模一样。
下面我以获取一个多维表格里的记录为例,给大家演示一下如何用 API 获取内容。
一、整体流程
下面这段是官方网站上的内容,写的也比较简洁。也没什么好修改的,我就直接粘贴过来了。整体你的流流程如下。后面我会分步骤让截图。
1、创建应用:开发者需先在开发者后台创建应用,根据需求选择合适的应用类型。了解应用类型
2、申请 API 权限:API 所需权限在接口文档有所标注,开发者可在【开发者后台-权限申请】处申请。
3、获取访问凭证:WPS 开放平台设置了多种访问凭证(也称为 access_token),不同的访问凭证代表了不同的资源访问权限。调用 API 时,需要在请求中携带访问凭证,以便获取权限范围内的资源信息。了解访问凭证
4、配置应用数据权限:当应用申请了部分 API 的权限(例如:通讯录)后,还需要配置相应的数据权限并提交审核。待审核通过后权限生效,才可以成功调用 API 获取数据,否则调用 API 时会返回权限错误。(第三方企业应用无需开发者申请,由租户企业在安装应用时设置)
5、设置 IP 白名单(可选):为了提升应用的安全性,可以为应用设置 IP 白名单。仅当源 IP 在白名单内时,WPS 开放平台才会响应,否则请求将被拒绝。
6、了解常用术语概念定义将有助于你正确调用接口。了解通用参数
7、了解平台通用错误码将有助于定位调用问题。了解通用错误码

想使用API文档,其实不用先搭建环境。平台提供了调试工具。
二、应用设置
1、创建应用
① 进入开放平台页面。点击右侧"开发者后台按钮"。可以进入到开发者后台。

② 点击"创建应用"按钮

③ 填写相关信息并配置


2、配置应用
① 开通权限你

② 创建版本



3、审核应用
登录到企业管理页面,对应用进行审核Wow!

三、调试接口
进入调试调试工作台
第一个入口

第二个入口

设定参数
我用的是应用类型


文件id
这个让我确认了好一阵子,垃圾。
https://www.kdocs.cn/l/{文件ID}?R=L1MvMQ==

验证
为了安全,总是弹这个玩意。烦死了。

环境设定



这个验证时间太多了,总得输入验证码,真是烦死了。


内容获取到了,其他的就可以按照文档去开发代码了。
四、认证与授权概述
为了提升 API 调用的安全性,WPS 开放平台设计了访问凭证(access_token)机制,调用 API 获取应用资源时,需要通过 access_token 对调用者身份进行鉴权,即告知 WPS 当前是谁、以什么身份获取什么租户的数据。
访问凭证是接入 WPS 开放平台的钥匙,将应用获得的所有数据访问和接口调用权限绑定在一起,允许应用对资源进行读写操作。建议开发者在正式开发前对 WPS 的访问凭证机制有充分的了解。
WPS 协作开放平台访问凭证分为 2 类:
- 用户授权凭证:用户委托应用执行对应操作,例如,调用 API 创建一篇云文档或一个日程。调用 API 所能操作的数据范围受限于用户本身的权限。
- 应用授权凭证:租户委托应用执行对应操作,例如,获取一个通讯录用户的信息。调用 API 所能操作的数据范围受限于应用的数据权限范围。
