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

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

一.前言

现在大企业用的办公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的结果。

相关推荐
pq113_63 分钟前
ftdi_sio应用学习笔记 3 - GPIO
笔记·学习·ftdi_sio
澄澈i8 分钟前
设计模式学习[8]---原型模式
学习·设计模式·原型模式
爱米的前端小笔记1 小时前
前端八股自学笔记分享—页面布局(二)
前端·笔记·学习·面试·求职招聘
alikami1 小时前
【前端】前端学习
学习
一只小菜鸡..1 小时前
241118学习日志——[CSDIY] [ByteDance] 后端训练营 [06]
学习
Hacker_Oldv3 小时前
网络安全的学习路线
学习·安全·web安全
蒟蒻的贤3 小时前
vue学习11.21
javascript·vue.js·学习
高 朗3 小时前
【GO基础学习】基础语法(2)切片slice
开发语言·学习·golang·slice
寒笙LED3 小时前
C++详细笔记(六)string库
开发语言·c++·笔记
码上有前3 小时前
解析后端框架学习:从单体应用到微服务架构的进阶之路
学习·微服务·架构