1、进入飞书并创建一个应用
链接: 创建应用
创建应用成功后需要审核通过,如果你拥有管理权限则可以自己进入管理后台通过审核,否则需要联系管理员通过审核
2、进入开发者后台
链接: 发者后台
3、在该调试平台上测试
以这个订阅审批事件为例
这一步比较关键的参数不太清楚可以使用下方链接查看获取方式
需要的参数
1、appId
2、appSecret
3、userId
4、approval_code
链接: 如何获取 App ID 和 App Secret ,该参数用于获取访问令牌
如果没有权限查看,可以联系管理员获取
链接: 如何获得 User ID、Open ID 和 Union ID?
如何获取 approval_code?
进入添加审批流程页面
可以在审批创建页面 点击进入编辑 approval_code 就是 下边路径中的 definitionCode 的值
XXX-YYY-ZZZ
https://www.feishu.cn/approval/admin/createApproval?
id=7221064099756015644&devMode=on&definitionCode=XXX-YYY-ZZZ
4、在本地添加飞书的SDK坐标
运行环境:JDK 1.8及以上
最新版本 maven 坐标
<!--飞书SDK-->
<dependency>
<groupId>com.larksuite.oapi</groupId>
<artifactId>oapi-sdk</artifactId>
<version>2.0.18</version>
</dependency>
如无法获取oapi-sdk依赖,请在 pom.xml 的 里增加
<project>
<repositories>
<repository>
<id>Central Repository</id>
<url>https://repo1.maven.org/maven2/</url>
</repository>
</repositories>
<dependencies>
...
</dependencies>
</project>
5、复制第3步调试成功的实例代码到本地
请求调试成功后可以直接复制下边的实例代码,然后粘贴到本地,我使用的是飞书提供的SDK,用起来比较方便
6、实例代码
public static final String APP_ID = "你的APPID";
public static final String APP_SECRET = "你的APPSECRET";
public static final String USER_ID = "你的USERID";
/**
* 获取访问令牌
*
* @return
*/
public static String getAuthenAccesstoken() {
// 构建client
Client client = Client.newBuilder(APP_ID, APP_SECRET)
.appType(AppType.SELF_BUILT) // 设置app类型,默认为自建
.logReqAtDebug(true)
.build();
// 发起请求
TenantAccessTokenResp resp = null;
try {
resp = client.ext().getTenantAccessTokenBySelfBuiltApp(
SelfBuiltTenantAccessTokenReq.newBuilder()
.appSecret(APP_SECRET)
.appId(APP_ID)
.build());
} catch (Exception e) {
throw new RuntimeException(e);
}
return resp.getTenantAccessToken();
}
7、个人总结
飞书的SDK支持飞书大部分接口的调用,有些还是需要自己构造请求,对于使用OpenFeign来构造请求飞书的接口可能会报错,我遇到过几个,最后改用RestTemplate来构造请求解决,也可以使用okhttp
飞书实例默认提供的实例就包含了SDK请求与OKhttp请求
参考地址