术语图鉴/后端基础/Webhook
←→切换Esc返回

Webhook Webhook

你可能会说

帮我处理一下Webhook,我不太确定最佳实践是什么。

「别人主动通知你」的机制。

「别人主动通知你」的机制。不用你反复去问「好了没」,事情完成后对方会自动向你指定的地址发一条消息。

生活类比

像快递到了发短信通知你——不用每隔五分钟跑下楼看,到了自然会叫你。

🎮 动手试试

选择题选择一个你认为最合适的答案

关于「Webhook」,以下哪个描述最准确?

你可以这样告诉 AI

帮我写一个接收 GitHub Webhook 的接口,收到 push 事件后自动执行部署脚本,验签防止伪造请求。

容易混淆?这样区分

Webhook Webhook≠
API API

API 是你主动去问(轮询),Webhook 是对方主动通知你(推送)。一个是「拉」,一个是「推」。

什么时候用

第三方服务事件通知

接入支付回调、GitHub 代码推送通知、CI/CD 构建完成通知时,用 Webhook 接收对方主动推送的事件。

和 AI 协作时

想让 AI 帮你对接 Webhook 时,直接说「帮我写一个接收 GitHub Webhook 的接口,验证签名后自动执行部署脚本」。

什么时候不用

实时性要求不高的场景

如果你可以接受每小时轮询一次获取最新状态,Webhook 不是必需的,定时任务就够了。

与外部集成无关的项目

如果你的应用完全独立运行、不需要接收任何第三方回调通知,无需了解 Webhook。

组成结构 · Anatomy

1
核心概念Core

「别人主动通知你」的机制。不用你反复去问「好了没」,事情完成后对方会自动向你指定的地址发一条消息。

2
实际表现In Practice

像快递到了发短信通知你——不用每隔五分钟跑下楼看,到了自然会叫你。

3
与 AI 的关联AI Context

和 AI 沟通时提到「配个 Webhook」,就是让第三方服务在事件发生时自动通知你的程序。

典型使用场景

接收推送通知
告诉 AI「帮我写一个 Webhook 接收接口,收到支付成功通知后自动更新订单状态并发送邮件」
想弄懂概念时
告诉 AI「用大白话给我解释什么是Webhook,举个生活中的例子」

延伸阅读