🇺🇸English

飞书多维表格

通过 Bitable API 操作数据、字段、视图和权限。

Base URL : https://open.feishu.cn/open-apis/bitable/v1

关键参数 :

• app_token: 多维表格 URL 中 /base/ 后的字符串
• table_id: 调用列表 API 获取

记录操作

请求示例 :

{
  "fields": {
    "名称": "测试",
    "金额": 100,
    "进度": 0.75,
    "评分": 4,
    "日期": 1770508800000,
    "状态": "进行中",
    "标签": ["重要", "紧急"],
    "完成": true,
    "负责人": [{"id": "ou_xxx"}],
    "电话": "13800138000",
    "链接": {"text": "官网", "link": "https://example.com"}
  }
}

⚠️ 数值不要传字符串，日期必须是 13 位毫秒时间戳。

字段类型格式

不支持 API 写入 : 公式、查找引用、创建时间、修改人、自动编号

日期格式转换 :

import datetime
ts = int(datetime.datetime(2026, 2, 9).timestamp() * 1000)
# → 1770508800000

字段管理

公式字段示例 :

{
  "type": 20,
  "field_name": "利润",
  "property": {"formula_expression": "[营收]-[成本]"}
}

关联字段示例 :

{
  "type": 18,
  "field_name": "关联客户",
  "property": {"table_id": "tblXXX", "multiple": true}
}

数据表管理

⚠️ 权限管理（重要） ：

• 通过 API 创建的表格默认只对机器人可见

• 创建后需添加用户为协作者：

  POST /permissions/{app_token}/members { "member_type": "user", "member_id": "ou_xxx", "perm": "full_access" }

• 权限类型：view / edit / full_access

视图管理

视图类型 : grid(表格) / kanban(看板) / gallery(画册) / gantt(甘特图)

权限管理

角色类型 : owner / editor / reader

最佳实践

1. 批量操作优先 （减少 API 调用）
2. 字段类型严格匹配 （避免写入失败）
3. 日期用毫秒时间戳 （Python: int(datetime.timestamp() * 1000)）
4. 关联字段实现关系型能力
5. 创建表格后立即添加用户为协作者 （避免不可见）
6. 单选字段自动创建选项 （直接写入选项文本即可）

测试验证

已通过实测验证的 15 种字段类型：

• 文本、进度、多选、单选、日期、复选框、电话、人员、超链接
• 邮箱、货币、评分、地理位置、单向关联、双向关联

测试表格：https://jvbmlo28x0.feishu.cn/base/YdOpb47PvalSbQsHPyXc7LrNnUh

Weekly Installs

125

Repository

alextangson/fei…u_skills

GitHub Stars

54

First Seen

Feb 20, 2026

Security Audits

Gen Agent Trust HubPassSocketFailSnykPass

Installed on

gemini-cli123

amp123

github-copilot123

codex123

kimi-cli123

opencode123