集成
Duaer 里 Webhook 的常见问题
Duaer 里 Webhook 的常见问题:多种请求方法、测试地址和生产环境地址、IP 白名单、路径冲突和返回字符串。
同时接收多种请求方法
- 打开 Webhook 节点的设置,打开 Allow Multiple HTTP Methods。
- 回到参数,默认接收 GET 和 POST;在 HTTP Methods 里加其它方法。
每种方法各有一个输出,可以分别接不同的后续节点。
测试地址和生产环境地址
- 测试地址:点「监听测试事件」后,Duaer 等待 2 分钟,收到的数据显示在编辑器里。
- 生产环境地址:数字组织发布后一直有效,直到取消发布。执行记录里能看到,编辑器里不实时显示。
详见 Webhook 地址。
用 curl 或 HTTP Request 发一次请求
把 <webhook 地址> 换成节点上的地址,方法和节点设置保持一致:
curl --request GET <webhook 地址>
curl --request POST <webhook 地址> --data 'key=value'
curl --request GET <webhook 地址> --header 'key: value'
curl --request POST <webhook 地址> --form 'file=@/path/to/file'也可以在另一个数字组织里用 HTTP Request 调用。用测试地址时,先让 Webhook 节点处于监听状态。
返回一段字符串
- Response Mode 选 When Last Node Finishes,Response Data 选 First Entry JSON。
- Options 里加 Property Name,填要返回的字段名,默认是 data。
- 在最后接一个 Edit Fields,只保留这个字段并填上字符串。
更灵活的做法是 Response Mode 选 Using 'Respond to Webhook' Node,在 Respond to Webhook 节点里直接写返回内容。
IP(s) Allowlist 里的地址连不上
自托管 Duaer 在反向代理后面时,Duaer 看到的是代理的地址。把 DUAER_PROXY_HOPS 设成代理的层数,Duaer 才会按真实来源地址判断。
同一路径和方法只能有一个 Webhook
Duaer 不允许两个已发布的 Webhook 使用同一路径和同一方法,否则提示「There is a conflict with one of the webhooks.」取消发布冲突的那个数字组织,或者改其中一个的路径或方法。
常见问题
Duaer 的 Webhook 测试地址能监听多久?
Duaer 在你点「监听测试事件」后等待 2 分钟。正式使用请发布数字组织并调用生产环境地址。
为什么 Duaer 的生产环境地址调用后编辑器里看不到数据?
Duaer 的生产环境地址调用记在执行记录里,不在编辑器里实时显示。打开执行列表查看那一次运行。
同组
Duaer 的内置集成
Duaer 的内置触发器、操作和凭证。触发器启动数字组织,操作在启动之后执行某一步。
集成Duaer 社区节点的风险
在 Duaer 里安装社区节点前,要清楚代码来自实例管理员信任的来源,并了解权限范围。
集成Duaer 社区节点排障
Duaer 社区节点装不上或跑失败时,先核对版本、权限和节点文档,再查实例日志。
集成在 Duaer 里对应用做自定义 API 调用
当 Duaer 某个应用节点没有你要的接口时,用 HTTP Request,并复用该应用已保存的认证。
集成Duaer 里的集成入口
Duaer 内置触发器、动作与凭证。社区节点是额外包。自定义操作用 HTTP Request 复用已保存的认证。
凭证Duaer 内置凭证目录
按服务列出 Duaer 内置凭证说明。创建流程见凭证总览;节点文档会链到对应服务页。
创建节点为 Duaer 创建自定义节点
内置节点和自定义操作都不够用、而且这一步要反复用时,再为 Duaer 写一个节点包。