跳至主要内容
短.be

Webhook

当特定事件发生时,服务器自动向指定 URL 发送 HTTP 请求的机制。用于实现实时联动。

2026 年 11 月 4 日 / 约 1 分钟阅读

数据分析

Webhook 是指当某个服务中发生特定事件时,自动向预先注册的 URL 发送 HTTP 请求 (通常为 POST) 的机制。就像"有事请打这个电话通知我"一样,实现了事件驱动的服务间联动。

Webhook 的反义词是轮询 (Polling)。轮询是定期发送"有新消息吗?"的查询方式,即使没有变化也会产生请求。Webhook 只在事件发生时才发送通知。

在提供 Webhook 的短链接服务中,应用场景之一是当链接被点击时接收通知。例如,将重要活动链接的点击事件推送到 Slack 频道,或将点击数据自动写入自有数据库。

Webhook 的实现需要注意几个要点。第一,接收端的端点通过 HTTPS 公开。Stripe 要求注册的端点是可公开访问的 HTTPS URL (据 2026 年 10 月时 Stripe 的文档)。第二,需要考虑 Webhook 发送失败时的重试处理。重试的次数和期限因服务而异,接收端宕机期间的事件可能会丢失。第三,通过验证签名 (如 HMAC-SHA256) 来确认 Webhook 的发送方。

使用 Webhook 的服务包括 GitHub (推送通知)、Stripe (支付完成通知)、Slack (消息发送) 等。

这篇文章对您有帮助吗?

相关术语

API 速率限制

限制客户端在特定时间内可以发送的 API 请求数量,防止滥用和保护服务稳定性。

API 密钥

用于认证和控制 API 访问的字符串。用于识别调用者身份并限制访问权限。

点击分析

对短链接点击数据进行收集和分析,了解用户行为和营销效果的方法。

服务器

在网络上为其他设备提供数据和服务的计算机。Web 服务器、邮件服务器和 DNS 服务器各自处理不同类型的请求。

HTTPS

HTTP 协议的安全版本,通过 SSL/TLS 加密保护浏览器与服务器之间的通信数据。

Webhook 重试

Webhook 通知投递失败时,以指数退避等方式间隔一段时间重新发送的机制。用于将短链接点击事件在之后传递给外部系统。

相关文章

网址缩短 API 使用指南 - 通过程序生成短链接

解说如何通过程序使用网址缩短服务的 API。介绍请求格式、响应结构和实现示例。

缩短 GitHub 的长 URL 提升开发工作流效率

详解如何用短链接管理 GitHub 中容易变长的 Issue、Pull Request、blob 路径等 URL。涵盖 README 中的应用、CI/CD 通知链接优化、文档站点的短链接导航、git.io 停用后的替代方案,以及开源项目中的实践案例。

Slack 和 Teams 中使用短链接的方法 - 链接预览与安全性兼顾指南

解说在 Slack 和 Microsoft Teams 中分享长链接的问题及短链接解决方案。介绍 OGP 预览控制和安全策略。

常见问题

Webhook 和 API 有什么区别?
API 是主动发送请求获取信息的"拉取型",Webhook 是事件发生时服务器自动推送通知的"推送型"。API 在需要时主动获取信息,Webhook 则在事件发生时接收信息。根据用途选择使用。
Webhook 接收失败后数据会丢失吗?
取决于服务。Stripe 在正式环境中会在最长 3 天内重试失败的投递,GitHub 则不会自动重新投递失败的请求 (可以手动重新投递) (据 2026 年 10 月时两家公司的文档)。也有先把收到的 Webhook 放入消息队列 (如 Amazon SQS) 再处理的设计。
Webhook 的安全措施有哪些?
通过验证签名来确认发送方。例如,GitHub 会在 X-Hub-Signature-256 请求头中附加 HMAC (SHA-256) 签名,接收方用共享的密钥计算同样的哈希值并进行比对。此外,接收端点通过 HTTPS 公开,也可以用允许列表限制发送方的 IP 地址。

把知识用到真实链接上

免费缩短网址