openlark-docs

飞书开放平台云文档服务模块 - 文档、表格、知识库 API（202 APIs，100% 覆盖，不含旧版本）

功能概览

特性

• ✅ 完整覆盖: 202 个 API，100% 实现覆盖率（排除 old 版本）
• ✅ 类型安全: 基于 enum 的端点系统，编译时检查
• ✅ 流式 API: Builder 模式，链式调用
• ✅ 统一入口: DocsClient 作为唯一公开入口
• ✅ 按需编译: 细粒度 feature，减少编译时间和二进制体积

功能选择（Feature Selection）

使用方式

在 Cargo.toml 中添加所需的 features：

[dependencies]
openlark = { version = "0.15", features = ["your-features"] }

可用功能（Features）

核心功能

云文档协同（CCM）

多维表格（Bitable）

知识库（Baike）

语言服务（Lingo）

会议纪要（Minutes）

云文档管理（Docs）

公告管理（Docx）

版本支持

功能组合

向后兼容别名

快速开始

基础使用

use openlark_client::prelude::*;
use openlark_docs::ccm::docs::v1::{GetDocsContentRequest, get_docs_content};

#[tokio::main]
async fn main() -> SDKResult<()> {
    // 1. 创建客户端（或使用 Client::from_env() 从环境变量读取）
    let client = Client::builder()
        .app_id("app_id")
        .app_secret("app_secret")
        .build()?;

    // 2. 使用 docs 字段获取配置，然后调用云文档 API
    let request = GetDocsContentRequest::new("doc_token", "docx", "markdown");
    let doc = get_docs_content(request, client.docs.ccm.docs.config(), None).await?;
    println!("Document: {:?}", doc);

    Ok(())
}

多维表格使用

# Cargo.toml
[dependencies]
openlark = { version = "0.15", features = ["bitable"] }

use openlark_client::prelude::*;

let client = Client::builder()
    .app_id("app_id")
    .app_secret("app_secret")
    .build()?;

// 访问多维表格（使用 Request 对象方式）
// 具体请参考 openlark_docs::base::bitable::v1::app 模块
let app = CreateAppRequest::new(client.docs.base.bitable().config().clone(), ...).execute().await?;

云文档协同使用

# Cargo.toml
[dependencies]
openlark = { version = "0.15", features = ["ccm"] }

use openlark_client::prelude::*;
use openlark_docs::ccm::drive::v1::file::DownloadFileRequest;

let client = Client::builder()
    .app_id("app_id")
    .app_secret("app_secret")
    .build()?;

// 访问云文档协同
let file = DownloadFileRequest::new(client.docs.ccm.drive.config().clone(), "file_token").execute().await?;
// 表格操作请参考 openlark_docs::ccm::sheets 模块

知识库使用

# Cargo.toml
[dependencies]
openlark = { version = "0.15", features = ["baike"] }

use openlark_client::prelude::*;

let client = Client::builder()
    .app_id("app_id")
    .app_secret("app_secret")
    .build()?;

// 访问知识库（使用 Request 对象方式）
// 具体请参考 openlark_docs::baike::v1 模块
let entity = CreateEntityRequest::new(client.docs.baike.service().config().clone(), ...).execute().await?;

性能优化建议

1. 选择性启用功能

仅启用您需要的功能模块：

# ❌ 不推荐：启用所有功能
openlark = { version = "0.15", features = ["full"] }

# ✅ 推荐：仅启用所需功能
openlark = { version = "0.15", features = ["bitable"] }  # 仅多维表格

2. 编译优化

# 发布版本使用更优化的编译配置
cargo build --release

# 检查优化后的二进制大小
ls -lh target/release/

3. 使用流式 Builder 模式

// ✅ 推荐：流式构建器
let request = CreateDocRequest::new(config, doc_body)
    .user_id_type(UserIdType::OpenId)
    .folder_token("folder_token");

// ❌ 不推荐：多次对象创建
let mut request = CreateDocRequest::new(config, doc_body);
request = request.user_id_type(UserIdType::OpenId);
request = request.folder_token("folder_token");

文档

• 飞书开放平台文档
• API 文档
• SDK 源码

许可证

项目许可证

贡献

欢迎贡献！请参阅 贡献指南。

支持与反馈

• 问题反馈：GitHub Issues
• 功能请求：GitHub Discussions