API 限制与配额

本文档详细介绍飞书 API 的使用限制和配额。

API 调用限制

频率限制

API 类型	限制	说明
读取类 API	20 QPS	如获取记录、查询字段
写入类 API	10 QPS	如创建、更新记录
多维表格操作	20 QPS	多维表格相关操作

超出限制

超出限制会返回错误：

{
  "code": 1254008,
  "msg": "rate limit exceeded"
}

解决方案：

• 添加延迟
• 使用缓存减少重复调用
• 申请提升配额（企业用户）

数据限制

多维表格

项目	限制
单表记录数	100,000 条
单次批量操作	500 条
字段数	100 个
字段名长度	100 字符
单条记录大小	100 KB

文档

项目	限制
单文档大小	10 MB
单文档字数	100 万字
云盘单文件	20 MB

附件

项目	限制
单文件大小	20 MB
文档内图片	无明确限制

速率限制处理

客户端处理示例

const RateLimiter = require('rate-limiter');

const limiter = new RateLimiter({
  points: 20, // 20 次
  duration: 1000 // 每秒
});

async function rateLimitedRequest(fn) {
  try {
    return await fn();
  } catch (error) {
    if (error.code === 1254008) {
      // 超出限制，等待后重试
      await new Promise(r => setTimeout(r, 1000));
      return await fn();
    }
    throw error;
  }
}

指数退避

async function retryWithBackoff(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.code === 1254008 && i < maxRetries - 1) {
        const delay = Math.pow(2, i) * 1000;
        await new Promise(r => setTimeout(r, delay));
        continue;
      }
      throw error;
    }
  }
}

配额管理

企业配额申请

企业用户可以申请提升配额：

1. 登录飞书开放平台
2. 进入"配额管理"
3. 提交配额提升申请
4. 等待审核（一般 1-3 工作日）

配额监控

async function checkQuota() {
  const app = await feishu_bitable_app.get({
    app_token: 'S404bxxxxx'
  });
  
  console.log('配额使用情况:', app.quota);
}

版本历史

本文档记录飞书插件的版本更新历史。

2026.03 版本

日期	版本	更新内容
2026-03-10	1.0.0	初始版本，发布核心功能
2026-03-10	1.0.1	修复多维表格字段类型错误
2026-03-11	1.0.2	添加批量操作支持
2026-03-11	1.0.3	优化 OAuth 流程

功能对比

功能	免费版	企业版
API 调用	100次/分钟	1000次/分钟
数据存储	1GB	100GB
用户数	10人	无限制

相关资源

• 飞书开放平台配额管理
• API 错误码文档
• 多维表格 API 文档