登记 Webhook 连接并核对外部投递限制
准备公开 HTTPS 目标,记录真实的下游防重复能力,分别管理连接、规则及未知外部结果。
Webhook 用于将受控事件摘要发送到预先登记的外部系统地址。当前已登记 Webhook 动作仅用于进销存低库存摘要;登记连接不等于可以把任意业务资料发送到该地址。
必需:本人有连接登记/管理权限及相应规则权限,企业允许本次数据外发,目标由真实下游负责人提供。没有必要权限时由负责人员处理,不借凭据或改用不受控出口。
登记连接
- 在“业务自动化 → Webhook 连接”打开“登记连接”。
- 填写“连接名称”和“HTTPS 端点”,只使用可公开访问的 HTTPS 地址;内网、回环及本机地址不适用。
- 只有下游确实按稳定请求键去重时,才勾选“下游支持 Idempotency-Key”。勾选只是配置声明,不是对方已实现防重复的证明。
- 核对“总超时(毫秒)”和“最大并发”。不要为让请求看似成功随意扩大;当前界面未提供自由请求头、签名密钥或全部连接参数编辑控件。
- 点击“登记连接”,等明确结果并在列表核对名称、地址、超时、并发和状态。
“登记连接”直接提交,没有额外确认窗口。总超时默认 8000 毫秒,即 8 秒,最大并发默认 1;填写整数并按页面校验处理,不把毫秒当秒。成功后表单会清空,新增连接从列表查验;表单清空不是登记失败。
登记响应未知时先核对原连接列表和当前提示,保留原表单内容,不刷新后另建同名连接来试探。连接列表可以分页;规则表单的连接下拉只读取一批记录,未出现在下拉不等于连接不存在,先核对其状态和读取范围。 表单提示下游防重复与网络错误重试有关,不能因此假设当前流程可安全重复发送。实际派发仍受当前授权和结果核对限制。
与规则关联
创建规则时选择“已登记 Webhook”、ERP 低库存预警及已启用连接,再按发布与启用处理。连接可选、规则可保存、发布成功和真正外部投递是不同阶段。
当前没有通用连接测试发送按钮。核对连接结果时,由集成负责人结合已有运行和下游记录确认,不用改动库存或重新触发业务来代替查询原结果。
关键结果边界
当前外部 Webhook 缺少可信的下游处理结果查询。即使观察到 HTTP 成功响应,也不能据此把工作标成业务已完成;请求已获派发授权更不能当成下游业务成功。
结果未知时保留原运行,由集成负责人结合下游原记录核对。当前恢复入口会拒绝仍未知的业务结果;不要重新建规则、切换地址、再次触发事件或反复恢复来绕过,以免重复处理。
停用与恢复连接
具备相应权限时在列表“停用”或“启用”,再读回状态;按钮直接提交,没有额外确认窗口。停用不删除已发生的外部效果,也不代替暂停规则。版本冲突或结果未知先读回,不盲目重复切换。
列表里的“稳定键,可有限重试”表示所登记的下游能力,不保证这次未知业务结果可再次派发。刷新失败时可能仍显示上次配置,先恢复读取再决定启停;下游结果无法核对时继续保留未知。
Last updated on
