Remarque : les webhooks GitHub ne prennent actuellement pas en charge IPv6, mais le feront à l’avenir. Le point de terminaison d’API REST /meta
retourne des plages IPv6 pour permettre cette transition.
Webhooks allow you to build or set up integrations, such as GitHub Apps or OAuth Apps, which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination.
Webhooks can be installed on GitHub Enterprise, an organization, a specific repository, or a GitHub App. Once installed, the webhook will be sent each time one or more subscribed events occurs.
You can create up to 250 webhooks for each event on each installation target (GitHub Enterprise Server instance, specific organization, or specific repository).
Events
Lors de la configuration d’un webhook, vous pouvez utiliser l’interface utilisateur ou l’API pour choisir les événements qui vous envoient des charges utiles. Seul l’abonnement aux événements spécifiques que vous prévoyez de gérer limite le nombre de requêtes HTTP adressées à votre serveur. Vous pouvez également vous abonner à tous les événements actuels et futurs. Par défaut, les webhooks ne sont abonnés qu'à l'événement push. Vous pouvez à tout moment modifier la liste des événements auxquels vous êtes abonné.
Each event corresponds to a certain set of actions that can happen to your organization and/or repository. For example, if you subscribe to the issues
event you'll receive detailed payloads every time an issue is opened, closed, labeled, etc.
For a complete list of available webhook events and their payloads, see "Événements et charges utiles du webhook."
Ping event
Lorsque vous créez un nouveau webhook, nous vous envoyons un simple événement ping
pour vous informer que vous avez correctement configuré le webhook. Cet événement n’est pas stocké et ne peut donc pas être récupéré via le point de terminaison de l’API Événements.
For more information about the ping
event webhook payload, see the ping
event.