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

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

一.前言

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

相关推荐
LuH112417 分钟前
【论文阅读笔记】Learning to sample
论文阅读·笔记·图形渲染·点云
兔C22 分钟前
微信小程序的轮播图学习报告
学习·微信小程序·小程序
海海不掉头发29 分钟前
苍穹外卖-day05redis 缓存的学习
学习·缓存
小木_.1 小时前
【Python 图片下载器】一款专门为爬虫制作的图片下载器,多线程下载,速度快,支持续传/图片缩放/图片压缩/图片转换
爬虫·python·学习·分享·批量下载·图片下载器
一棵开花的树,枝芽无限靠近你2 小时前
【PPTist】组件结构设计、主题切换
前端·笔记·学习·编辑器
犬余2 小时前
设计模式之桥接模式:抽象与实现之间的分离艺术
笔记·学习·设计模式·桥接模式
啊瞑3 小时前
学习记录:配置mybatisplus的分页查询插件,mybatis-plus-jsqlparser 依赖
学习
码到成龚3 小时前
SQL server学习09-数据库编程(上)
数据库·学习
数据爬坡ing3 小时前
小白考研历程:跌跌撞撞,起起伏伏,五个月备战历程!!!
大数据·笔记·考研·数据分析
咖肥猫3 小时前
【ue5学习笔记2】在场景放入一个物体的蓝图输入事件无效?
笔记·学习·ue5