Webhook
Webhook
Webhook(网络钩子)
核心释义
Webhook 是一种反向回调机制：当源系统发生事件（如货物签收、报关放行、船舶到港）时，主动把数据推送到订阅方指定的 URL，与"轮询"（定期主动查询）相比更实时、更省资源。物流系统的典型应用：货代系统订阅承运人的签收事件，签收瞬间自动触发后续流程（通知客户、生成结算、更新报表）。Webhook 的实现要点：订阅方须暴露可公网访问的接收地址；发送方须做签名校验防止伪造；接收方要处理失败重试与消息去重（网络异常时消息可能重复推送）。Webhook 与 API 是互补关系——大批量数据仍宜 API 拉取，实时事件用 Webhook 推送。
知识扩展
实操要点
1. 订阅方暴露可公网访问的接收地址，内网地址收不到推送；
2. 做签名校验防伪造，避免伪造消息触发错误流程；
3. 失败重试与去重，网络异常时消息可能重复或丢失；
4. 大批量数据仍用 API 拉取，Webhook 负责实时事件；
5. 与供应商对接前确认消息格式与安全机制。
2. 做签名校验防伪造，避免伪造消息触发错误流程；
3. 失败重试与去重，网络异常时消息可能重复或丢失；
4. 大批量数据仍用 API 拉取，Webhook 负责实时事件；
5. 与供应商对接前确认消息格式与安全机制。
常见误区
误区一：Webhook 替代一切——大批量仍宜 API 拉取配 Webhook 推送，两者分工。
误区二：Webhook 不需要安全——无签名校验的 Webhook 易被伪造，安全机制必须有。
误区三：推送失败不用管——没有重试机制，丢失的事件无法追溯。
误区二：Webhook 不需要安全——无签名校验的 Webhook 易被伪造，安全机制必须有。
误区三：推送失败不用管——没有重试机制，丢失的事件无法追溯。
业务实例
车队系统签收后通过 Webhook 实时把 POD 推给货代系统。
来源依据
API 集成规范 / 物流系统 Webhook 实践