Webhook 是一种事件驱动的回调机制：你把一个接收地址（回调 URL）告诉对方，当特定事件发生时（如支付成功、代码推送），对方主动 POST 数据到你的地址。它常被称作「反向 API」。
与其不停问「有新数据了吗」，不如让对方有变化时主动通知你。Webhook 就是这套「事件回调」机制。本文讲清原理、与轮询的区别、安全与重试要点。
YesApi Pro 网关承载 Webhook 接收、限流与审计，统一管理回调流量。
Webhook 是一种事件驱动的回调机制：你把一个接收地址（回调 URL）告诉对方，当特定事件发生时（如支付成功、代码推送），对方主动 POST 数据到你的地址。它常被称作「反向 API」。
| 维度 | 轮询（Polling） | Webhook |
|---|---|---|
| 模式 | 你定时去问「有新吗」 | 对方有事主动通知你 |
| 实时性 | 有延迟（取决于间隔） | 近实时 |
| 资源 | 大量空请求浪费 | 仅在事件时触发 |
① 你注册回调 URL 并订阅事件；② 事件触发时，对方组装负载（Payload）POST 到该 URL；③ 你的服务校验签名后处理业务。整个过程无需你持续发起请求。
支付结果通知、代码仓库推送（CI/CD）、表单提交、物联网设备告警、第三方平台状态变更等。凡「事件发生→需立刻反应」都适合 Webhook。