Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

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

提供链式调用的客户端构建方式。配置状态委托给 core ConfigBuilder， Client 仅叠加 30 秒默认超时与构建期严格校验策略。

示例

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() -> Self

🆕 创建新的构建器实例

在 core 默认值之上应用 Client 策略：默认请求超时 30 秒。

pub fn app_id<S: Into<String>>(self, app_id: S) -> Self

🆔 设置应用ID

pub fn app_secret<S: Into<String>>(self, app_secret: S) -> Self

🔑 设置应用密钥

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

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

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

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

pub fn base_url<S: Into<String>>(self, base_url: S) -> Self

🌐 设置基础URL

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

🔓 允许自定义 base_url 域名

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

⏱️ 设置请求超时时间

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

🔄 设置重试次数

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

📝 启用或禁用日志

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

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

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

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

🔧 添加自定义 HTTP header

pub fn from_env(self) -> Self

🌍 从环境变量加载配置

在链式调用当前位置叠加 OPENLARK_* 环境变量；后写覆盖前写。

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

🔨 构建客户端实例

与 Client::with_core_config 共用同一私有 checked 构造 seam。

返回值

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

错误

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

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

Formats the value using the given formatter.

impl Default for ClientBuilder

fn default() -> Self

Returns the “default value” for a type.