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.ccm...
    // - 认证：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

🔧 获取客户端配置

pub fn registry(&self) -> &DefaultServiceRegistry

📋 获取服务注册表

pub fn core_config(&self) -> &Config

🔧 获取底层 core 配置（高级用法/调试用）

pub fn api_config(&self) -> &Config

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

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

pub fn is_configured(&self) -> bool

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

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

🆕 创建带有自定义配置的客户端

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

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

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

Trait Implementations

impl ClientErrorHandling for Client

fn handle_error<T>(&self, result: Result<T>, operation: &str) -> Result<T>

处理错误并添加客户端上下文

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

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

处理异步错误并添加客户端上下文

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.

impl LarkClient for Client

fn config(&self) -> &Config

🔧 获取客户端配置

fn is_configured(&self) -> bool

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

fn app_id(&self) -> &str

🔍 获取应用ID

fn app_secret(&self) -> &str

🔑 获取应用密钥

fn base_url(&self) -> &str

🌐 获取API基础URL

fn timeout(&self) -> Duration

⏱️ 获取请求超时时间

fn retry_count(&self) -> u32

🔄 获取重试次数

fn is_log_enabled(&self) -> bool

📝 检查是否启用了日志