飞书开发学习笔记(一)-应用创建和测试

飞书开发学习笔记(一)-应用创建和测试

一.前言

现在大企业用的办公IM软件中,飞书是口碑最好的,不得不说,字节在开发产品方面,确实有自己独到的竞争力,比如说抖音、头条、飞书。在办公会议和云文档的体验上,其它的办公IM软件可以说完全不是对手。为了在办公中能够高效率的完成一些数据的收集并创建文书文档,学习一下飞书的开发是很有意义的。基于此,我想从飞书的开发文档开始,学习一些飞书的二次开发方案,并记录为学习笔记。

二.开发文档

飞书的开发文档地址为: https://open.feishu.cn/document/home/index

根据应用的能力形态,飞书应用主要可分为 机器人、网页、小程序、小组件四类。

不过如果简单的二次开发,飞书提供了强大的API文档和工具台。也就是说,利用python或者C#,只要进行简单的API调用,就能完成飞书的开发,对于云文档的操作就可以完成了。

那么,首先利用飞书API工具台和API函数,进行简单开发,就是比较适合的入门学习。

2.1 飞书开放平台

飞书开放平台:https://open.feishu.cn/app?lang=zh-CN

打开之后,进入开放平台页面。

开发工具之前,需要先自建一个应用,这个目的只是建立一个应用入口,作为应用的入口和凭证。

建立之后,就能够出现开发的工具台和教程。

在设计应用中,首先是介绍文档。
开放能力介绍: https://open.feishu.cn/document/client-docs/intro

飞书的框架中,开放平台的所有能力,不论是小程序/H5/机器人,还是开发API接口,都能通过飞书提供的API进行开发。

优秀开发案例: 地址

这里有一些比较好的开发案例,其中有一个:利用服务器端OpenAPI实现文档自动导出就挺好的,多逛一逛,看一看能够学习到不少开发的思路和点子。

2.2 搭建应用

点击 创建企业自建应用

创建完成后,可先不添加应用能力,比如"小程序/组件/机器人"。

由于正式的应用需要发布后,向企业申请权限,调试比较麻烦,所以这里先创建一个测试版本。

利用测试企业和人员来测试API的情况,是比较方便的。

切换到测试应用后,可以申请API操作相关应用权限。

在测试应用中,默认自己就是管理员身份,因此申请权限时是申请就开通。

2.3 飞书API

测试应用和权限开通后,就可以看到这样一个API调试台,左侧有应用的鉴权凭证,

左下方有全部的API列表,右侧则是API调试的请求头和请求体,按照要求填写后请求参数后,就可以点击

开始调试 进行API调试了。

飞书开放平台提供的 API 遵循 RESTful 风格,请求 URL 的格式为:

调用服务端 API 的流程如下图所示。

创建应用。在开发者后台,根据实际需求,创建自建应用或者商店应用。

仅拥有 ISV 资质的用户可以创建商店应用。有关 ISV 的详细介绍,请参考如何入驻飞书开放平台。

获取访问凭证。飞书开放平台设置了多种访问凭证(也称为 access_token),不同的访问凭证代表了不同的资源访问权限。调用 API 时,需要在 HTTP Header 中携带访问凭证,以便获取权限范围内的资源信息。

申请 API 权限。如果要调用 API,需要先获取接口调用权限;如果涉及到访问敏感字段,还需获取访问敏感字段的权限。

(可选)配置应用数据权限。当应用申请了部分 API 的权限(例如,通讯录、飞书人事企业版)后,还需要配置相应的数据权限并提交审核。待审核通过后权限生效,才可以成功调用 API 获取数据,否则调用 API 时会返回权限错误。

(可选)设置 IP 白名单。为了提升应用的安全性,可以为应用设置 IP 白名单。仅当源 IP 在白名单内时,飞书开放平台才会响应,否则请求将被拒绝。

调用 API。完成上述步骤后,便可以调用 API 了。你可以参考 API 文档,了解 API 的具体功能。

三.测试应用

3.1 鉴权

刷新口令token后,在API的自建应用获取中,将API的请求体中的app_id和app_secret复制下来,开发中需要使用。

3.2 测试API

以 自建应用获取 tenant_access_token 这个API为例,测试工作台中需要填写的参数分别为请求头和请求体。

测试工作台中,请求头和请求体已经自动填好了,点击 开始调试 就可以看到响应的结果。

返回的状态码为 200 显示测试API成功。

返回的数据是一个json字符串,返回了code,expire,msg和tenant_access_token四个结果,而第四个就是口令。

至此,初步的应用创建和测试已经成功,利用API查询到了tenant_access_token的结果。

相关推荐
d111111111d7 小时前
在STM32F103C8T6中什么是读写寄存器模型,有什么用,可以干什么,详细解释。
笔记·stm32·单片机·嵌入式硬件·学习
金士顿7 小时前
DI滤波学习
学习
qq_401780827 小时前
1.信号完整性(方波信号的频谱特征)
学习
星梦客7 小时前
FRP 内网穿透工具部署教程
网络·经验分享·笔记
iiiiii117 小时前
【论文阅读笔记】FOCAL 离线元强化学习,从静态数据中快速适应新任务
论文阅读·人工智能·笔记·学习·机器学习·学习方法·具身智能
dingzhihui0141377 小时前
扣子工作流中飞书多维表格插件参数介绍
飞书·coze·扣子
calvinpaean7 小时前
FlashOcc 论文学习
学习
calvinpaean7 小时前
MonoOcc 论文学习
学习
van久7 小时前
.Net Core 学习:LINQ 详解
学习·.netcore·linq
jimmyleeee7 小时前
人工智能基础知识笔记二十三:构建一个可以查询数据库的Agent
人工智能·笔记