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

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

一.前言

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