このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2021-06-09. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

webhook について

インテグレーションの構築とセットアップに役立つwebhookの動作の基本を学んでください。

webhookを使うと、GitHub AppOAuth Appのような、GitHub.com上の特定のイベントをサブスクライブするインテグレーションを構築し、セットアップできます。 それらのイベントのいずれかがトリガーされると、webhookに設定されたURLにHTTP POSTペイロードが送信されます。 webhookは、外部のIssueトラッカーを更新したり、CIビルドをトリガーしたり、バックアップミラーを更新したり、さらにはプロダクションサーバーへのデプロイをしたりするのに利用できます。 想像力が及ぶかぎりのことが可能です。

webhookは、 GitHub EnterpriseOrganization、特定のリポジトリ、GitHub Appにインストールできます。 インストールされると、1つ以上のサブスクライブされたイベントが発生するたびに、webhookが送信されます。

作成できるwebhookは、それぞれのインストールターゲット(GitHub Enterprise Server のインスタンス、特定のOrganization、あるいは特定のリポジトリ)上の各イベントに対して最大250です。

イベント

webhookを設定する際には、ペイロードを送信するイベントを選択するためにUIもしくはAPIが使用できます。 処理する計画の特定のイベントだけをサブスクライブすることによってのみ、サーバーへのHTTPリクエスト数を制限できます。 現在、そして未来のすべてのイベントをサブスクライブすることもできます。 デフォルトでは、webhookはプッシュイベントだけをサブスクライブします。 サブスクライブするイベントのリストは、いつでも変更できます。

それぞれのイベントは、Organizationやリポジトリに生じうる一連のアクションに対応します。 たとえば、issuesイベントにサブスクライブしているなら、Issueのオープン、クローズ、ラベル付けなどが生じるたびに詳細なペイロードを受信することになります。

For a complete list of available webhook events and their payloads, see "Webhook events and payloads."

Pingイベント

新しいwebhookが作成されると、シンプルなpingイベントが送信され、webhookが正しくセットアップされたことを知らせます。 このイベントは保存されないので、Events APIエンドポイントを通じて取り出すことはできません。

pingイベントのwebhookのペイロードに関する詳細な情報についてはpingイベントを参照してください。

問題がまだ解決していませんか?

GitHubコミュニティで質問するサポートへの連絡