报错排查
在 Duaer 里排查 Webhook 404「is not registered」
调用 Duaer 的 Webhook 返回 404 和 is not registered,多半是测试地址没在监听,或正式地址对应的数字组织还没发布。
Duaer 返回的报错
- The requested webhook "POST 你的路径" is not registered.
- This webhook is not registered for GET requests. Did you mean to make a POST request?
第一种是这个地址现在没有登记;第二种是地址对,HTTP 方法不对。
先分清测试地址和正式地址
Duaer 的 Webhook 有两个地址。Test URL 路径里是 /webhook-test/,Production URL 是 /webhook/。两者行为不同:
- Test URL:只在你点了「执行工作流程」或 Listen for test event 之后可用,而且只接一次调用。调用过一次,再调就是 404。重新点一次再试。
- Production URL:数字组织发布后才登记。没发布、或发布后又停用,都是 404。点右上角「发布」,见 在 Duaer 里保存和发布数字组织。
- 外部系统长期调用的,一律填 Production URL。Test URL 只用来在画布上看一次数据。
其他常见原因
- 方法不对:报错第二种。把 Webhook 节点的 HTTP Method 改成调用方实际用的方法,或让调用方改。
- 路径改过:改了 Webhook 节点的 Path 后要重新发布,旧地址立即失效。
- 正式调用不在画布上显示:去 执行记录 里看,不是没触发。
常见问题
Duaer 的 Webhook 测试地址为什么第二次就 404?
Duaer 的 Test URL 每点一次「执行工作流程」只接一次调用。再测就再点一次,长期调用改用 Production URL。
Duaer 的 Webhook 已发布,正式地址还是 404?
看调用方的地址是不是 /webhook/ 而不是 /webhook-test/,HTTP 方法和 Path 是否和 Duaer 的 Webhook 节点一致。改过 Path 要重新发布。
同组
触发
在 Duaer 里用 Webhook 接收请求
在 Duaer 里,Webhook 是数字组织的入口。测试地址只在监听时有效,生产环境地址要发布之后才接外部请求。
管理在 Duaer 里保存并发布数字组织
在 Duaer 里,编辑会先存成草稿。点发布之后,定时、Webhook 和生产地址才按这一版运行。
管理在 Duaer 里查看执行记录
在 Duaer 里,一次执行就是数字组织跑完的一轮。侧栏的执行记录列出成功、错误、已取消、运行中、排队和等待。
触发在 Duaer 里用 Respond to Webhook 回复调用方
在 Duaer 里,Respond to Webhook 决定 Webhook 或表单什么时候、用什么内容回复。前面的 Webhook 要把 Respond 设成 Using Respond to Webhook Node。