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

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

一.前言

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

相关推荐
风吹心凉25 分钟前
ROS2核心概念
学习
砚凝霜1 小时前
软考网络工程师|第 9 章 网络诊断命令 + 故障工具 + 故障排查完整笔记
网络·笔记
jaysee-sjc1 小时前
【JavaWeb】Tlias智能学习辅助系统|后端Web实战(登录认证)
java·开发语言·前端·学习·mybatis
MartinYeung51 小时前
[论文学习]AdInject:通过广告投放对Web代理发起真实世界黑盒攻击
前端·学习
runafterhit1 小时前
【学习地图】Linux学习类 · 文章索引
linux·运维·学习
九硕智慧建筑一体化厂家2 小时前
打破系统孤岛!IBMS 一体化平台,构建智慧楼宇全域管控体系
运维·网络·人工智能·笔记·智慧城市
黑泽明*2 小时前
LVS-Keepalived-全解析
服务器·开发语言·笔记·学习·php
浪潮BB机2 小时前
2026飞书妙记与通义听悟会议录音转写工具实测横评
飞书·语音识别·效率工具·ai工具·录音转写·会议纪要
大模型码小白2 小时前
AI安全前沿:AI大模型安全防护的前沿技术
java·网络·人工智能·python·深度学习·学习·安全
熊猫钓鱼>_>3 小时前
Seedance 2.0 技术深度解析:重构AI视频生成的世界模型新范式
人工智能·笔记·ai·重构·音视频·变革·sedence2.0