Skip to main content

此版本的 GitHub Enterprise 已停止服务 2022-10-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

关于 web 挂钩

本文内容

了解 Webhook 如何帮助您构建和设置集成的基础知识。

Webhook 允许生成或设置集成,例如 GitHub AppsOAuth Apps,以订阅 GitHub.com 上的某些事件。 当触发其中某个事件时,我们将向 web 挂钩的配置 URL 发送 HTTP POST 有效负载。 Web 挂钩可用于更新外部议题跟踪器、触发 CI 构建、更新备份镜像,甚至部署到生产服务器。 您只受想象力的限制。

Webhook 可以安装在 GitHub Enterprise组织、特定存储库或 GitHub App 上。 安装后,每当发生一个或多个订阅事件时,都会发送 web 挂钩。

最多可以为每个安装目� � (GitHub Enterprise Server 实例、特定组织或特定存储库)上的每个事件创建最多 250 个 Webhook。

事件

配置 web 挂钩时,您可以使用 UI 或 API 选择哪些事件将向您发送有效负载。 仅订阅您计划处理的特定事件可限制对服务器的 HTTP 请求数。 您也可以订阅所有当前和未来的事件。 默认情况下,web 挂钩只订阅推送事件。 您可以随时更改订阅事件的列表。

每个事件对应于您的组织和/或仓库可能发生的一组特定操作。 例如,如果订阅了 issues 事件,则在每次打开、关闭、� �记问题等时,� 都会收到详细的有效负载。

有关可用 Webhook 事件及其有效负载的完整列表,请参阅“Webhook 事件和有效负载”。

Ping 事件

当� 创建新的 Webhook 时,我们将向� 发送一个简单的 ping 事件,让� 知道� 已正确设置 Webhook。 此事件不会存储,� 此� 法通过事件 API 终结点进行检索。

有关 ping 事件 Webhook 有效负载的详细信息,请参阅 ping 事件。