Struct Client 

pub struct Client {

    pub cardkit: CardkitClient,
    pub auth: AuthClient,
    pub docs: DocsClient,
    pub communication: CommunicationClient,
    pub hr: HrClient,
    pub meeting: MeetingClient,
    pub ai: AiClient,
    pub workflow: WorkflowService,
    pub platform: PlatformService,
    pub application: ApplicationService,
    pub helpdesk: HelpdeskService,
    pub mail: MailService,
    pub analytics: AnalyticsService,
    pub user: UserService,
    pub security: SecurityClient,
    pub bot: BotService,
    /* 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

cardkit: CardkitClient

CardKit meta 调用链：client.cardkit.v1.card.create(…)

auth: AuthClient

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

docs: DocsClient

Docs meta 调用链入口：client.docs.config() / 各 async helper（如 search_bitable_records_all）…

communication: CommunicationClient

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

hr: HrClient

HR meta 调用链入口：client.hr.attendance / client.hr.corehr / client.hr.hire …

meeting: MeetingClient

Meeting meta 调用链入口：client.meeting.vc.v1.note.get(…) 等（ADR 0001：room/meeting/reserve 空壳已砍，真实 builder 经 strict 路径）

ai: AiClient

AI meta 调用链入口：client.ai.chat.create() …

workflow: WorkflowService

Workflow meta 调用链入口：client.workflow.v2().task().create() …

platform: PlatformService

Platform meta 调用链入口：client.platform.app_engine… …

application: ApplicationService

Application meta 调用链入口：client.application.applet… …

helpdesk: HelpdeskService

Helpdesk meta 调用链入口：client.helpdesk.ticket… …

mail: MailService

Mail meta 调用链入口：client.mail.group… …

analytics: AnalyticsService

Analytics meta 调用链入口：client.analytics.report… …

user: UserService

User meta 调用链入口：client.user.system_status… …

security: SecurityClient

Security meta 调用链入口：client.security.acs… …

bot: BotService

Bot meta 调用链入口：client.bot.search_bot() …

Implementations

impl Client

pub fn from_env() -> Result<Client, CoreError>

🔥 从环境变量创建客户端

环境变量

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 registry(&self) -> &DefaultServiceRegistry

📋 获取服务注册表

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<Client, CoreError>

🆕 使用统一 CoreConfig 创建客户端

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

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

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

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

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

Trait Implementations

impl ClientErrorHandling for Client

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

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

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

where T: Send + 'a, F: Future<Output = Result<T, CoreError>> + Send + 'a,

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

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<(), Error>

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) -> Option<Duration>

⏱️ 获取请求超时时间

fn retry_count(&self) -> u32

🔄 获取重试次数

fn is_log_enabled(&self) -> bool

📝 检查是否启用了日志