飞书多维表格操作。记录 CRUD、字段管理、视图、权限、公式、关联。

飞书多维表格通过 Bitable API 操作数据、字段、视图和权限。 Base URL : https://open.feishu.cn/open apis/bitable/v1 认证与 Token 获取从 feishu skills 根目录执行共享脚本：请求头统一使用 Authorization: Bearer ${TOKEN} 。如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：环境变量 : FEISHU APP ID FEISHU APP SECRET 本地缓存 : ./.feishu token cache.json （未过期直接复用，默认提前 5 分钟刷新）关键参数 : app token : 多维表格 URL 中 /base/ 后的字符串 table id : 调用列表 API 获取记录操作 API 端点说明新增单条 POST /apps/{app token}/tables/{table id}/records 批量新增 POST .../records/batch create 最多 500 条，支持 Upsert 更新 PUT .../records/{record id} 批量更新 POST .../records/batch update 最多 500 条批量删除 POST .../records/batch delete 最多 500 条查询 POST .../records/search 支持 filter/sort/分页分页查询全部记录（单次最多 500 条，循环直到 has more: false ）：请求示例 : ⚠️ 数值不要传字符串，日期必须是 13 位毫秒时间戳。字段类型格式 type ui type 中文名写入格式示例 1 Text 多行文本字符串 "办公用品" 1 Email 邮箱字符串 "test@example.com" 2 Number 数字数值 100 2 Currency 货币数值 1280.50 2 Progress 进度数值(0~1) 0.25 (25%) 2 Rating 评分数值(1~5) 3 3 SingleSelect 单选字符串 "支出" (自动创建选项) 4 MultiSelect 多选字符串数组 ["餐饮","交通"] 5 DateTime 日期毫秒时间戳 1770508800000 7 Checkbox 复选框布尔值 true 11 User 人员对象数组 [{"id":"ou xxx"}] 13 Phone 电话字符串 "13800138000" 15 Url 超链接对象 {"text":"名称","link":"https://..."} 17 Attachment 附件对象数组 [{"file token":"xxx"}] 18 SingleLink 单向关联字符串数组 ["recuxxx"] 21 DuplexLink 双向关联字符串数组 ["recuxxx"] 22 Location 地理位置字符串 "116.397,39.903" 不支持 API 写入 : 公式、查找引用、创建时间、修改人、自动编号日期格式转换 : 字段管理 API 端点说明获取字段列表 GET .../fields 返回 type 和 ui name 新增字段 POST .../fields {"field name":"新字段","type":1} 更新字段 PUT .../fields/{field id} 修改单选需提供完整 property 删除字段 DELETE .../fields/{field id} 公式字段示例 : 关联字段示例 : 数据表管理 API 端点说明创建多维表格 POST /apps {"name":"数据库名称"} 列出数据表 GET /apps/{app token}/tables 新增数据表 POST /apps/{app token}/tables {"table":{"name":"表名"}} 批量新增表 POST .../tables/batch create 最多 10 张表删除数据表 DELETE .../tables/{table id} 复制数据表 POST .../tables/{table id}/copy ⚠️ 权限管理（重要）：通过 API 创建的表格默认只对机器人可见创建后需添加用户为协作者：权限类型： view / edit / full access 视图管理 API 端点说明列出视图 GET .../tables/{table id}/views 创建视图 POST .../tables/{table id}/views {"view name":"新视图","view type":"grid"} 删除视图 DELETE .../views/{view id} 视图类型 : grid (表格) / kanban (看板) / gallery (画册) / gantt (甘特图) 权限管理 API 端点说明创建协作者 POST /apps/{app token}/roles/{role id}/members/batch create 删除协作者 POST .../members/batch delete 更新权限 PUT /apps/{app token}/roles/{role id} 角色类型 : owner / editor / reader ⚠️ 不存在的接口 /apps/:app token/tables/:table id/statistics 该接口不存在，飞书官方文档中未提供统计汇总 API。如需统计数据（如求和、计数），建议： 1. 用 POST .../records/search 拉取全量记录后在客户端计算 2. 在多维表格中创建公式字段（如 SUM 、 COUNT ）后通过 API 读取字段值最佳实践 1. 批量操作优先（减少 API 调用） 2. 字段类型严格匹配（避免写入失败） 3. 日期用毫秒时间戳（Python: int(datetime.timestamp() 1000) ） 4. 关联字段实现关系型能力 5. 创建表格后立即添加用户为协作者（避免不可见） 6. 单选字段自动创建选项（直接写入选项文本即可）测试验证已通过实测验证的 15 种字段类型：文本、进度、多选、单选、日期、复选框、电话、人员、超链接邮箱、货币、评分、地理位置、单向关联、双向关联测试表格：https://jvbmlo28x0.feishu.cn/base/YdOpb47PvalSbQsHPyXc7LrNnUh

feishu-bitable