使用“发送 HTTP 请求”节点时,需要先完成正确配置:先设置自动化触发条件,并确认当前账号已具备编辑权限和对应 API 调用权限;然后填写请求 URL(不包含查询参数),选择匹配的请求方法;接着配置 Authorization 与 Content-Type 请求头,并根据实际接口需求填写 JSON、Form Data 或 Raw 类型的请求体;最后解析返回的 JSON 响应结果,并写入对应字段,便于后续流程使用。

如果你想在飞书多维表格中通过自动化流程调用第三方服务,例如把一条记录发送为飞书消息卡片、自动创建日程,或同步到企业百科,就必须正确配置“发送 HTTP 请求”节点。配置不完整或参数填写错误,通常会导致请求失败、接口报错,或直接返回空响应。
先确认自动化触发条件和权限
打开多维表格 → 点击右上角「自动化」→ 新建流程 → 选择一个触发条件(如「当记录新增时」或「当字段更新时」)。【必须确保当前账号对目标多维表格拥有编辑权限,并且已开通飞书开放平台相关 API 的调用权限】
点击「添加执行操作」→ 搜索并选择「发送 HTTP 请求」。需要注意的是,这个节点不能单独使用,必须放在触发条件之后,才能在飞书多维表格自动化中正常执行。
填写请求地址与方法
在「请求URL」栏中填写要调用的接口地址,例如飞书消息卡片 API:https://open.feishu.cn/open-apis/bot/v2/hook/xxx,或者日历 API:https://open.feishu.cn/open-apis/calendar/v4/calendars。
然后从下拉菜单中选择请求方法:GET / POST / PUT / PATCH / DELETE。大多数写入类接口操作(如发消息、创建日程、创建任务)通常使用 POST;读取类接口(如查询用户信息、获取日历列表)一般使用 GET。
⚠️ 注意:请求 URL 中不能直接携带查询参数(如 ?user_id=abc),所有动态参数都必须填写到下方的「查询参数」区域,否则系统会忽略这些参数,导致 HTTP 请求结果不符合预期。
配置请求头(Headers)
点击「添加请求头」,按键值对方式填写。最关键的 Header 包括:
Authorization → 值填写 Bearer (token 需要提前通过飞书开放平台获取,并存入多维表格中的「单行文本」字段,再通过「引用字段」方式插入)
Content-Type → 按接口文档要求填写,发送 JSON 数据时必须设置为 application/json;上传文件时则可能需要设置为 multipart/form-data。
如果没有填写 Authorization,或 Content-Type 设置错误,HTTP 请求通常会直接返回 401 或 415 错误,而且很多情况下不会提示更详细的失败原因。
构造请求体(Body)
只有当请求方法为 POST、PUT、PATCH 时,才需要配置请求体内容。
方法一:选择「JSON」格式 → 在文本框中填写标准 JSON,支持引用字段,例如:
{"msg_type":"interactive","card": {"elements":[{"tag":"div","text":{"content":"{{标题}} 已提交","tag":"plain_text"}}]}}
方法二:选择「Form Data」→ 每行填写一个键值对,适合上传文件或兼容一些老接口。字段值支持引用「附件」字段,但【附件字段必须为「文件」类型,并且单条记录最多只能引用 1 个文件】。
方法三:选择「Raw」→ 手动输入原始文本内容(如 XML、纯文本等),这种方式实际使用较少,通常只在特殊接口调用或临时调试 HTTP 请求时使用。
解析响应结果
第一步:在「响应体」下拉菜单中选择解析方式 —— 大多数飞书 API 返回的都是 JSON,因此选择 JSON;如果接口返回纯文本(例如短链接生成结果),则选择 Text;如果不需要处理响应内容,可以选择 none。
第二步:如果选择了 JSON,就需要配置「返回值」路径,使用点号语法提取目标字段,例如:data.bot_access_token 或 calendar.id。如果路径填写错误,对应字段会显示为空,但系统通常不会主动报错。
第三步:勾选「将返回值写入记录」→ 选择目标字段(必须为「单行文本」或「数字」类型),这样就可以把 API 返回的 ID、token、状态码等内容写回飞书多维表格中,方便后续自动化流程继续判断和处理。
