全部教程

原创专题

n8n Webhook 返回结果:单次响应与多条 item 怎样选

设置 Respond to Webhook 的返回对象与状态码,用独立检查区分请求成功和业务成功。

AI Nav City撰写 / 更新 资料核验

调用方收到 HTTP 200,并不表示 AI 任务得到了预期结果。本文目标是为合成分类接口写一份响应契约,并在 n8n 里选择对应返回模式。前提是能编辑 Webhook 与 Respond to Webhook 节点,了解自己的调用方;本页没有开启端点或发送请求。

操作与验收顺序

  1. 连通响应路径

    让 Webhook 使用 Respond to Webhook 节点。[1]

  2. 选响应内容

    区分首条、全部 item 与自定义对象。[1]

  3. 验收调用结果

    同时检查 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]

本文来源

本站原创整理;官方说明与编辑建议分别标注。

  1. n8n · 核验来源
    查看资料