关于 Webhook 类型
Webhook 只能访问在其安装的仓库、组织、GitHub Marketplace 帐户、GitHub Sponsors 帐户或 GitHub 应用中可用的事件。
您无法为单个用户帐户创建 Webhook,也无法为特定于用户资源的事件(如个人通知或提及)创建 Webhook。
要创建和管理 Webhook,您必须拥有或具有创建 Webhook 并监听其事件的资源的管理员访问权限。例如,要管理组织中的 Webhook,您需要该组织的管理员权限。
某些 Webhook 事件是特定类型的 Webhook 独有的。例如,组织 Webhook 可以订阅仅在组织级别发生的事件,而仓库 Webhook 则无法订阅这些事件。有关每个 Webhook 的具体可用性的更多信息,请参阅“Webhook 事件和有效负载”。
更多信息,请参阅“关于 Webhooks”。
仓库 Webhooks
您可以在仓库中创建 Webhook 以订阅该仓库中发生的事件。您必须是仓库所有者或拥有仓库中的管理员访问权限才能在仓库中创建和管理 Webhook。您无法在您没有所需权限的仓库中创建、编辑或删除 Webhook。
您可以在单个仓库中创建多个 Webhook。但是,您最多只能创建 20 个订阅每个单独事件类型的 Webhook。例如,在单个仓库中,您最多只能创建 20 个不同的 Webhook,每个 Webhook 都订阅 `push` 事件。
您可以使用 GitHub 网页界面或 REST API 来管理仓库 Webhook。更多信息,请参阅“创建 Webhooks”、“编辑 Webhooks”和“禁用 Webhooks”。有关使用 REST API 管理仓库 Webhook 的更多信息,请参阅“仓库 Webhook 的 REST API 端点”。
组织 Webhooks
您可以在组织中创建 Webhook 以订阅该组织中发生的事件。组织 Webhook 可以订阅在组织拥有的所有仓库中发生的事件。它们还可以订阅在组织级别发生的、不在任何特定仓库中的事件,例如向组织添加新成员时。
您必须是组织所有者才能在组织中创建和管理 Webhook。
您可以在单个组织中创建多个 Webhook。但是,您最多只能创建 20 个订阅每个单独事件类型的 Webhook。例如,在单个组织中,您最多只能创建 20 个不同的 Webhook,每个 Webhook 都订阅 `push` 事件。
您可以使用 GitHub 网页界面或 REST API 来管理组织 Webhook。更多信息,请参阅“创建 Webhooks”、“编辑 Webhooks”和“禁用 Webhooks”。有关使用 REST API 管理组织 Webhook 的更多信息,请参阅“组织 Webhook 的 REST API 端点”。
GitHub Marketplace Webhooks
您可以创建 Webhook 来订阅与您在 GitHub Marketplace 中发布的应用相关的事件。您每个 GitHub Marketplace 应用只能创建一个 Webhook。只有应用所有者或拥有该应用的组织的应用管理员才能创建和管理 GitHub Marketplace Webhook。
GitHub Marketplace Webhook 无法删除,但您可以将其停用以停止接收 Webhook 传递。
您可以使用 GitHub 网页界面来管理 GitHub Marketplace Webhook。更多信息,请参阅“创建 Webhooks”、“编辑 Webhooks”和“禁用 Webhooks”。
GitHub Sponsors Webhooks
您可以创建 Webhook 来订阅与 GitHub Sponsors 相关的事件。您最多只能为一个 GitHub Sponsors 帐户创建 20 个 Webhook。
您必须是帐户所有者或拥有赞助帐户的管理员访问权限才能管理赞助 Webhook。
您可以使用 GitHub 网页界面来管理 GitHub Sponsors Webhooks。更多信息,请参阅“创建 Webhooks”、“编辑 Webhooks”和“禁用 Webhooks”。
GitHub 应用 Webhooks
您可以配置 GitHub 应用,以便在应用已获得访问权限的仓库或组织中发生特定事件时接收 Webhook。
每个 GitHub 应用都有一个由 GitHub 自动创建的单个 Webhook。默认情况下,Webhook 未订阅任何事件。您可以配置 Webhook 订阅的事件。GitHub 应用 Webhook 无法删除,但您可以将其停用以停止接收 Webhook 传递。
您可以使用 GitHub 网页界面或 REST API 来管理 GitHub 应用 Webhook。更多信息,请参阅“创建 Webhooks”、“编辑 Webhooks”和“禁用 Webhooks”。有关使用 REST API 管理 GitHub 应用 Webhook 的更多信息,请参阅“GitHub 应用 Webhook 的 REST API 端点”。