Os webhooks permitem que você crie ou configure integrações, como aplicativo GitHubs ou aplicativo OAuths, que assinam determinados eventos no GitHub.com. Quando um desses eventos é acionado, enviaremos uma carga de POST por HTTP POST para a URL de configuração do webhook. Os webhooks podem ser usados para atualizar um rastreador de problemas externo, acionar criações de CI, atualizar um espelho de backup, ou até mesmo fazer uma implantação no seu servidor de produção. A sua imaginação é o único limite.
Os webhooks podem ser instalados em uma instância do GitHub Enterprise Server, uma organização, um repositório específicoou em um aplicativo GitHub. Uma vez instalado, o webhook será enviado cada vez que ocorrer um ou mais eventos assinados.
Você pode criar até 250 webhooks para cada evento em cada destino de instalação instância(GitHub Enterprise Server de organização específica ou repositório específico).
Eventos
When configuring a webhook, you can use the UI or API to choose which events will send you payloads. Only subscribing to the specific events you plan on handling limits the number of HTTP requests to your server. You can also subscribe to all current and future events. By default, webhooks are only subscribed to the push event. You can change the list of subscribed events anytime.
Cada evento corresponde a um certo conjunto de ações que podem ocorrer na sua organização e/ou repositório. Por exemplo, se você assinar o evento problemas, você receberá cargas detalhadas toda vez que uma tarefa for aberta, fechada, etiquetada, etc.
Consulte "Cargas de evento do eebhook" para a lista de eventos de webhook disponíveis e suas cargas.
Evento de ping
When you create a new webhook, we'll send you a simple ping event to let you know you've set up the webhook correctly. This event isnt stored so it isn't retrievable via the Events API. You can trigger a ping again by calling the Ping a repository webhook endpoint.
Para obter mais informações sobre a carga do webhook do evento de ping, consulte o evento ping.