Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

🏗️ 客户端构建器 - 流畅API

提供链式调用的客户端构建方式

示例

use openlark_client::Client;
use openlark_client::Result;
use std::time::Duration;

fn main() -> Result<()> {
    let _client = Client::builder()
        .app_id("your_app_id")
        .app_secret("your_app_secret")
        .base_url("https://open.feishu.cn")
        .timeout(Duration::from_secs(30))
        .build()?;
    Ok(())
}

Implementations

impl ClientBuilder

pub fn new() -> ClientBuilder

🆕 创建新的构建器实例

pub fn app_id<S>(self, app_id: S) -> ClientBuilder

where S: Into<String>,

🆔 设置应用ID

pub fn app_secret<S>(self, app_secret: S) -> ClientBuilder

where S: Into<String>,

🔑 设置应用密钥

pub fn app_type(self, app_type: AppType) -> ClientBuilder

🏷️ 设置应用类型（自建 / 商店）

pub fn enable_token_cache(self, enable: bool) -> ClientBuilder

🔐 设置是否允许自动获取 token（默认 true）

pub fn base_url<S>(self, base_url: S) -> ClientBuilder

where S: Into<String>,

🌐 设置基础URL

pub fn allow_custom_base_url(self, allow: bool) -> ClientBuilder

🔓 允许自定义 base_url 域名

pub fn timeout(self, timeout: Duration) -> ClientBuilder

⏱️ 设置请求超时时间

pub fn retry_count(self, retry_count: u32) -> ClientBuilder

🔄 设置重试次数

pub fn enable_log(self, enable: bool) -> ClientBuilder

📝 启用或禁用日志

pub fn max_response_size(self, size: u64) -> ClientBuilder

设置响应体最大大小限制（字节）

pub fn add_header<K, V>(self, key: K, value: V) -> ClientBuilder

where K: Into<String>, V: Into<String>,

🔧 添加自定义 HTTP header

pub fn from_env(self) -> ClientBuilder

🌍 从环境变量加载配置

pub fn build(self) -> Result<Client, CoreError>

🔨 构建客户端实例

返回值

返回配置好的客户端实例或验证错误

错误

如果配置验证失败，会返回相应的错误信息，包含用户友好的恢复建议

Trait Implementations

impl Clone for ClientBuilder

fn clone(&self) -> ClientBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClientBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for ClientBuilder

fn default() -> ClientBuilder

Returns the “default value” for a type.