用途:用于创建和管理飞书多维表格 App,在数据表中新增、查询、修改、删除记录,并管理字段(列)、视图和数据表。
主要能力:支持 27 种字段类型;提供 app、table、field、view、record 等工具,覆盖创建多维表格、创建数据表、创建字段与视图、记录的单条与批量增删改查;支持高级筛选(10 种 operator)与多字段排序。
使用方式:写记录前先调用 feishu_bitable_app_table_field.list 获取字段 type/ui_type,再按类型构造值。人员字段用 [{id:"ou_xxx"}];日期用毫秒时间戳;单选传字符串,多选传字符串数组;附件需先上传到当前表格并使用返回的 file_token;超链接用 {link, text} 对象。批量操作单次不超过 500 条,超过需分批;同一数据表不支持并发写,需串行调用并延迟 0.5-1 秒。app.create 默认表可能含空行,插入前建议先 list 加 batch_delete 清理。
适用场景:批量导入客户数据、按条件筛选查询、字段与视图配置、附件与关联字段处理等。
限制:单个 App 数据表加仪表盘上限 100,单表记录 20000、字段 300、视图 200;单元格文本 10 万字符、附件 100、人员 1000;从其他数据源同步的数据表不支持增删改记录;公式字段与查看引用字段只读;删除操作无法恢复。常见错误码 125406X 多为字段值格式问题,125408X 多为 property 结构问题。