【微服务】Java 对接飞书多维表格使用详解

本文链接：https://blog.csdn.net/congge_study/article/details/143248063

一、前言

飞书通过多维表格提供了强大的数据支撑能力，借助飞书开放平台，应用程序可以通过飞书平台提供的开放API能力操作多维表格，以满足业务灵活的数据处理需要。本文将详细介绍如何基于飞书开放平台，在微服务项目中打通对飞书多维表的数据操作流程。

二、前置操作

2.1 开通企业飞书账户

默认情况下，你在公司的组织机构下，直接使用你的账号激活并登录的账户即可

2.2 确保账户具备多维表操作权限

由于后文会对一些多维表做数据测试，因此再正式开始之前，选择你需要操作的多维表，并提前开通操作权限

2.3 创建一张测试用的多维表

在飞书的知识库中创建一个测试用的多维数据表，如下，并提前初始化几条数据

2.4 获取飞书开放平台文档

百度搜索：飞书开放平台，地址：https://open.feishu.cn/ ，通过 ” 开发文档 ”进入

2.5 获取Java SDK

在后文中，需要通过程序代码操作多维表，因此需要在代码中导入飞书开放平台提供的SDK，官方给出了2种使用方式，通过SDK提供的API调用，或者通过传统的HTTP方式调用，以Java语言为例进行说明，git对应的SDK获取地址：SDK链接

三、应用App相关操作

应用程序对飞书提供的各类能力的操作，均以应用的维度为前提，所以在对接飞书API之前，需要结合实际业务需求进行应用的创建。

3.1 创建应用过程

操作入口：应用入口

如下，点击创建应用

跳转链接来到下面的页面

按要求填写应用的信息，然后点击创建，创建成功后就可以在列表上看到刚刚创建的这个应用了

3.2 应用发布过程

应用必须要通过发布之后，应用具备的操作各类飞书文档、多维表格的能力才能生效

点击应用图标，跳转到下面的应用操作控制台，在这个页面，图中两个参数请妥善保管，后面在程序代码中会多处使用。

点击 ”版本管理与发布”

点击创建版本，参照下面的格式要求填写，提交之后需要等待飞书管理员审核通过。

3.3 应用添加操作权限

这里的操作权限，可以理解为，对上述添加的这个应用能够做哪些事情，是操作多维表数据？修改/删除文档？还是获取组织机构的人员？定一个具体的操作范围。有点像你在阿里云控制台，或者一些SAAS的操作平台上面，根据自身的需求选择一些平台提供的各类操作能力。如下，在当前的应用页面，点击左侧 ” 权限管理”

在右侧可以看到，平台主要提供了API权限和数据权限两种类型，不同类型的权限下面细分了很多种小场景下的权限能力，可以根据自身的需求，为你当前创建的应用勾选对应的权限，比如后文需要操作多维表，所以我这里勾选了与多维表相关的权限。

四、多维表应用授权操作

在正式通过应用程序SDK操作飞书多维表之前，还需要在多维表为上述创建的这个应用授权，表示授权这个应用对这个多维表的操作权限，如下，找到多维表对接的流程：多维表对接流程

找到上文中创建的那个测试用的多维表，然后通过多维表上面的 ... 找到添加文档应用

在弹出的搜索框中搜索前面创建并审核通过的那个应用名称并添加即可（应用必须通过审核，否则这里无法搜索到），这一步操作成功后，就表示应用具备了操作当前这个多维表的能力了。

五、使用控制台API调试操作多维表

飞书提供了控制台在线调试各类API的能力，通过在线调试，不仅可以快速的看到结果，也可以基于调试的参数生成应用程序中可以真实使用的程序代码，同时也可以在调试阶段进一步理解API需要的参数，以及参数的获取方式，从而对API的使用有更深一层的理解，下面以操作多维表格为例进行说明。