飞书相关配置

本文档提供在n8n中使用飞书多维表格API的关键配置参数和示例，帮助您快速实现数据查询与写入操作。

创建应用，链接多维表格

1.打开飞书开放平台首页，点击“创建应用”。 2.设置应用相关信息 3.选择创建版本 4.发布版本 5.选择权限管理 6.勾选多维表格权限 7.获取凭证APPID和密钥 8.安装飞书社区节点，点击进入设置。输入“n8n-nodes-feishu-lite“点击确认安装。 9.配置凭证信息 10.进入多维表格，点击三个点，往下滚动（注意⚠️有时候找不到是因为屏幕看不到，往下滚动一下）。看到更多。选择“添加文档应用”。 11.搜索刚才创建的应用名称。 12.点击获取信息。 13.大功告成。可以看到相关数据。

https://wangxiaojian.feishu.cn/base/LCXYbxUW8ayhv0sgWaDcqKXonQh?table=tblycnZZ22Ezz9Jb&view=vewnxzAFoD
https://wangxiaojian.feishu.cn/base/多维表格 Token?table=多维表格ID&view=视图

查询记录

官方文档地址：飞书多维表格查询API文档

查询示例

"filter": {
  "conditions": [
    {
      "field_name": "职位",
      "operator": "is",
      "value": [
        "初级销售员"
      ]
    },
    {
      "field_name": "销售额",
      "operator": "isGreater",
      "value": [
        "10000.0"
      ]
    }
  ],
  "conjunction": "and"
}

操作符说明

操作符	说明	特殊限制
is	等于	-
isNot	不等于	不支持日期字段
contains	包含	不支持日期字段
doesNotContain	不包含	不支持日期字段
isEmpty	为空	-
isNotEmpty	不为空	-
isGreater	大于	-
isGreaterEqual	大于等于	不支持日期字段
isLess	小于	-
isLessEqual	小于等于	不支持日期字段
like	LIKE 运算符	暂未支持
in	IN 运算符	暂未支持

字段目标值（value）填写说明

• 当 operator 为 isEmpty 或 isNotEmpty 时，value 需填空值 "value":[]
• 当 value 填空值 [] 时，请确保按照 "value":[] 格式传入 value，否则将报缺失 value 值的错误

---

新增记录

官方文档地址：飞书多维表格新增记录API文档

字段类型与值格式

字段类型	填写说明
文本	填写字符串格式的值
数字	填写数字格式的值
单选	填写选项值，对于新的选项值，将会创建一个新的选项
多选	填写多个选项值，对于新的选项值，将会创建一个新的选项。如果填写多个相同的新选项值，将会创建多个相同的选项
超链接	超链接格式示例 {"text": "n8n中文社区","link": "https://www.n8nzh.com/"}
日期	填写毫秒级时间戳
复选框	填写 true 或 false
人员	填写用户的open_id、union_id 或 user_id，类型需要与 user_id_type 指定的类型一致
附件	使用文件上传接口获取file_token，格式见下方示例

附件格式示例

[
  {
    "file_token": "DRiFbwaKsoZaLax4WKZbEGCccoe"
  },
  {
    "file_token": "BZk3bL1Enoy4pzxaPL9bNeKqcLe"
  }
]

附件上传文件

附件字段需填写附件token，需要先调用上传素材或分片上传素材接口将附件上传至该多维表格中。

官方上传文件接口：飞书文件上传API

注意：素材大小不得超过20MB。要上传大于20MB的文件，需使用分片上传素材相关接口。

返回信息示例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "file_token": "boxcnrHpsg1QDqXAAAyachabcef"
  }
}