appType
|
client.marketplaceApp()
|
设置 App 类型为商店应用,ISV 开发者必须要设置该选项。
|
logReqAtDebug
|
client.logReqAtDebug(boolean logReqAtDebug)
|
设置是否开启 Http 请求参数和响应参数的日志打印开关;
开启后,在 debug 模式下会打印 http 请求和响应的 headers,body 等信息。
在排查问题时,开启该选项,有利于问题的排查。
|
BaseUrl
|
client.openBaseUrl(BaseUrlEnum baseUrl)
|
设置飞书域名,默认为FeishuBaseUrl,可用域名列表为:
```java
public enum BaseUrlEnum {
FeiShu("https://open.feishu.cn"),
LarkSuite("https://open.larksuite.com"),
;
}
```
|
tokenCache
|
client.tokenCache(ICache cache)
|
设置 token 缓存器,用来缓存 token 和 appTicket, 默认实现为内存。
如开发者想要定制 token 缓存器,需实现下面 Cache 接口:
```Java
public interface ICache {
// 获取缓存值
String get(String key);
// 设置缓存值
void set(String key, String value, int expire, TimeUnit timeUnit);
}
```
对于 ISV 开发者来说,如需要 SDK 来缓存 appTicket,需要实现该接口,实现提供分布式缓存。
|
disableTokenCache
|
client.disableTokenCache()
|
设置是否开启 TenantAccessToken 的自动获取与缓存。
默认开启,如需要关闭可传递 false。
|
helpDeskId、helpDeskToken
|
client.helpDeskCredential(String helpDeskId, String helpDeskToken)
|
该选项仅在调用服务台业务的 API 时需要配置。
|
requestTimeout
|
client.requestTimeout(long timeout, TimeUnit timeUnit)
|
设置 SDK 内置的 Http Client 的请求超时时间,默认为0代表永不超时。
|
httpTransport
|
client.httpTransport(IHttpTransport httpTransport)
|
设置传输层实现,用于替换 SDK 提供的默认实现。
开发者可通过实现下面的 IHttpTransport 接口来设置自定义的 传输实现:
```Java
public interface IHttpTransport {
RawResponse execute(RawRequest request) throws Exception;
}
```
目前提供了两种实现:
1. 基于 [OKhttp](./larksuite-oapi/src/main/java/com/lark/oapi/core/httpclient/OkHttpTransport.java)
的实现,使用 [demo](./sample/src/main/java/com/lark/oapi/sample/api/ClientSample.java)
2. 基于 [Apache HttpClient](./larksuite-oapi/src/main/java/com/lark/oapi/core/httpclient/ApacheHttpClientTransport.java)
的实现,使用 [demo](./sample/src/main/java/com/lark/oapi/sample/api/ClientSample.java)
|