后端、数据与安全 深入了解 C · 行业惯例

Webhook

Webhook 回调

Webhook 是事件发生时向外发送的 HTTP 回调,用来通知另一个系统作出响应。

看看怎样运作
也有人这样说 Webhook事件回调通知接口

看看怎样运作

原创情境示例Webhook 回调

另一个例子

支付服务会把经过签名的 payment.succeeded 事件发送到订单服务。

主要部分

  1. 01来源请求
  2. 02解析或处理节点
  3. 03响应、耗时与失败状态

什么时候用

每份载荷都要签名,处理方式要具备幂等性,发送失败要重试,也要保存持久的事件记录。

什么时候不要用

不要假设事件会按顺序到达或只发送一次,也不要信任尚未验证的发送方。

代码里的名称

POST callback + signature

上线前要检查

检查接口约定、任何情况下都不能破坏的规则、授权与输入限制。测试重试、重复执行只生效一次、超时与部分失败。验证数据完整性、兼容性、监控、恢复与回到上一版。

可以直接复制的需求

预期结果:为这套系统设计或检查 Webhook 回调 (Webhook),并让数据保持正确、安全且容易维护。 用户场景:支付服务会把经过签名的 payment.succeeded 事件发送到订单服务。 技术概念或控制措施:Webhook 回调 (Webhook)。 适用理由:每份载荷都要签名,处理方式要具备幂等性,发送失败要重试,也要保存持久的事件记录。 不应使用的情况:不要假设事件会按顺序到达或只发送一次,也不要信任尚未验证的发送方。 工程要求:定义输入、输出、接口约定,以及任何情况下都不能破坏的规则。说明授权与输入检查范围。定义失败、超时、重试和重复执行只生效一次的规则。也要定义数据迁移与兼容限制。 运营要求:加入监控信号与隐藏敏感数据的日志。设置容量上限并写好操作手册。测试恢复与回到上一版的流程。 验收标准:接口约定与失败路径测试通过。重试或部分失败时,数据与授权规则仍正确。性能上限、监控、恢复与回到上一版的方法都已验证。 证据与限制(证据边界):没有一份官方标准能涵盖全部内容。不同团队、平台或框架的用法可能不同。 待确认:程序运行环境、数据位置、流量形态、数据一致需求和安全边界。也要确认兼容周期、服务目标(SLO)与恢复上一版的限制。

检查这份需求

请 AI 编程助手检查当前如何使用 Webhook 回调 (Webhook)。 定义:Webhook 是事件发生时向外发送的 HTTP 回调,用来通知另一个系统作出响应。 生产环境检查:检查接口约定、任何情况下都不能破坏的规则、授权与输入限制。测试重试、重复执行只生效一次、超时与部分失败。验证数据完整性、兼容性、监控、恢复与回到上一版。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

C
这个术语有多正式?

行业惯例

工作中经常会用到这个术语。列出的来源可能说明用法或限制,但不会定义全部内容。

没有一份官方标准能涵盖全部内容。不同团队、平台或框架的用法可能不同。

适用范围
只包含来源有说明的内容:正式名称、定义、使用指南、避免事项
文档状态
稳定
核验日期
2026-07-30

证据来源与适用范围

正式来源 · GitHub · 稳定 About webhooks 适用范围: 正式名称、定义、使用指南、避免事项 本页用途: 提供背景,不是正式定义 来源涵盖内容: 正式名称, 定义, 使用指南, 避免事项

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。