Java端飞书接口开发

背景

由于业务需求，目前开发的系统中需要调用飞书的接口，打通飞书和该系统，实现统一管理员工的目的。
这次主要开发的接口是获取飞书部门和员工列表的接口、通过企业自建应用发送飞书消息的接口、获取飞书打卡日报的接口。开发过程中还是挺烦躁的，飞书提供的SDK还不完善，部分接口是未封装的，需要map接收然后转化数据格式，开发文档中也没有提供SDK的说明，需要的接口都是自己在类里面找到的。

开发流程

pom文件引入依赖

<dependency>
	<groupId>com.larksuite.oapi</groupId>
	<artifactId>larksuite-oapi</artifactId>
	<version>1.0.5</version>
</dependency>

上图可知，飞书的SDK能够支持的服务只有4个

上图的项目结构中我们可以看到，提供的服务在service中，由于官方文档中没有提供那个功能需要调用的接口代码，所以需要我们自己去这写服务代码中找到需要的接口，下面我将用获取部门的接口为例，来说一下如何找到自己需要的接口。

获取部门列表接口开发（有SDK接口可调用）

从开发文档中我们可以看到获取部门信息列表的接口请求路径是https://open.feishu.cn/open-apis/contact/v3/departments
由项目结构的contact可知，通讯录相关的接口应该是在这个目录下，于是我们进入这个目录。

由于上图的红框中代码basepath等于"contact/v3"，我们需要请求的地址也是有这个的，所以确定我们找对了地方

通过页面搜索功能，终于找到了对应的请求方法，看样子，就是这个接口了。