Struct Client 

pub struct Client {
    pub auth: AuthClient,
    pub communication: CommunicationClient,
    /* private fields */
}

🚀 OpenLark客户端 - 极简设计

特性

• 零配置启动：Client::from_env()
• 单入口：meta 链式字段访问（client.docs/...）
• 编译时feature优化
• 高性能异步
• 现代化错误处理

示例

use openlark_client::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    // 从环境变量创建客户端
    let client = Client::from_env()?;

    // meta 链式入口（需要对应 feature）
    // - 通讯：client.communication.im...
    // - 文档：client.docs.config()...
    // - 认证：client.auth.app / client.auth.user / client.auth.oauth

    Ok(())
}

Fields

auth: AuthClient

Auth meta 调用链入口：client.auth.app / client.auth.user / client.auth.oauth

communication: CommunicationClient

Communication meta 调用链入口：client.communication.im / client.communication.contact …

Implementations

impl Client

pub fn from_env() -> Result<Self>

🔥 从环境变量创建客户端

环境变量

export OPENLARK_APP_ID=your_app_id
export OPENLARK_APP_SECRET=your_app_secret
export OPENLARK_BASE_URL=<https://open.feishu.cn>  # 可选

返回值

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

示例

use openlark_client::Client;

let _client = Client::from_env();

pub fn builder() -> ClientBuilder

🏗️ 创建构建器

pub fn config(&self) -> &Config

🔧 获取客户端配置（统一的 CoreConfig）

pub fn core_config(&self) -> &Config

🔧 获取底层 core 配置

与 Self::config 返回同一份配置。保留此别名是为了向后兼容。

pub fn api_config(&self) -> &Config

🔧 获取可直接传给函数式 API 的认证后配置

与 Self::config 返回同一份配置。保留此别名是为了让 业务侧更容易理解它的用途：可直接传给 openlark_docs::*、 openlark_auth::* 等函数式 API。

pub fn is_configured(&self) -> bool

✅ 检查客户端是否已正确配置

pub fn with_core_config(config: Config) -> Result<Self>

🆕 使用统一 CoreConfig 创建客户端

与 ClientBuilder::build 共用私有构造 seam：Config::validate（含域名白名单）

• Client 零超时规则 + token provider 装配。

pub async fn execute_with_context<F, T>( &self, operation: &str, f: F, ) -> Result<T>

where F: Future<Output = Result<T>>,

🔧 执行带有错误上下文的操作

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.