原创专题
n8n Webhook 返回结果:单次响应与多条 item 怎样选
设置 Respond to Webhook 的返回对象与状态码,用独立检查区分请求成功和业务成功。
调用方收到 HTTP 200,并不表示 AI 任务得到了预期结果。本文目标是为合成分类接口写一份响应契约,并在 n8n 里选择对应返回模式。前提是能编辑 Webhook 与 Respond to Webhook 节点,了解自己的调用方;本页没有开启端点或发送请求。
操作与验收顺序
连通响应路径
让 Webhook 使用 Respond to Webhook 节点。[1]
选响应内容
区分首条、全部 item 与自定义对象。[1]
验收调用结果
同时检查 HTTP 状态、JSON 结构和业务状态。[1]
先明确调用方要什么
原创契约:返回一个对象,包含 request_id: demo-request、status: completed 与 result.category: billing。示例只描述预期形状,不是已发生的任务。调用方需要检查这三个字段,不仅检查 HTTP 状态;若允许多个结果,另明确返回数组还是包含 results 的对象。[1]
接入响应节点
在 Webhook 节点将 Respond 设为 Using Respond to Webhook node,再把 Respond to Webhook 放在结果生成之后。该响应节点只运行一次,表达式按首个输入 item 求值。Respond With 的 First Incoming Item 返回首条 JSON;All Incoming Items 返回全部 JSON item;JSON 使用 Response Body 自定义对象。多条输入时先选模式,避免无意只返回首条。[1]
状态码与工作流路径分开
Add Option 中可设置 Response Code 与 Response Headers。官方说明:工作流完成但未执行响应节点时返回标准 200 消息;首次响应前发生错误时返回 500 错误消息;后续响应节点不再发出第二次响应。因此分支路径是否抵达响应节点也要检查,不能从一次 200 推断自定义对象已返回。[1]
检查成功与失败样例
在你的测试端点分别检查成功、缺结果与提前失败路径,记录状态码、Content-Type 和原始响应体;响应不符合契约时停止把它当成功结果。本文离线检查了合成响应字段,没有启动 Webhook、做网络请求或调用模型。公开端点的认证和隐私设置需另行配置,本练习不提供对外发布结论。[1]
本文来源
本站原创整理;官方说明与编辑建议分别标注。