Webhooks do repositório

Sobre webhooks de repositório

Os webhooks de repositório permitem que você receba conteúdo POST HTTP sempre que determinados eventos acontecem em um repositório. Você pode usar a API REST para gerenciar o repositório, a organização e os webhooks de aplicativo. Você pode listar entregas de webhook para um webhook ou obter e reenviar uma entrega individual para um webhook, que pode ser integrado a um aplicativo ou serviço externo. Você também pode usar a API REST para alterar a configuração do webhook. Por exemplo, você pode modificar a URL da carga, tipo de conteúdo, verificação de SSL e segredo. Para obter mais informações, consulte:

Se você deseja configurar um único webhook para receber eventos de todos os repositórios de sua organização, confira nossa documentação da API REST para Webhooks de organização.

Além da API REST, o GitHub também pode servir como um hub PubSubHubbub para repositórios.

Receber Webhooks

Para que GitHub envie cargas de webhook, seu servidor deve ser acessível pela internet. É altamente recomendável o uso de SSL para que possamos enviar cargas criptografadas por HTTPS.

Cabeçalhos de webhook

GitHub enviará ao longo de vários cabeçalhos de HTTP para diferenciar entre tipos de evento e identificadores de carga. Confira Cabeçalhos de webhook para ver detalhes.

PubSubHubbub

O GitHub também pode servir como um hub PubSubHubbub para todos os repositórios. O PSHB é um simples protocolo de publicação/assinatura que permite o registro de servidores para receber atualizações quando um tópico é atualizado. As atualizações são enviadas com uma solicitação HTTP do tipo POST para uma URL de chamada de retorno. As URLs dos tópicos dos pushes de um repositório do GitHub estão neste formato:

https://github.com/{owner}/{repo}/events/{event}

O evento pode ser qualquer evento de webhook disponível. Para obter mais informações, confira "Eventos e cargas de webhook".

Formato da resposta

O formato padrão é o que os ganchos de pós-recebimento existentes devem esperar: um corpo JSON enviado como o parâmetro payload em um POST. Você também pode especificar o recebimento do corpo JSON bruto com um cabeçalho Accept ou uma extensão .json.

Accept: application/json
https://github.com/{owner}/{repo}/events/push.json

URLs de chamada de retorno

As URLs de retorno de chamada podem usar o protocolo HTTP.

# Send updates to a PostBin bin
https://www.toptal.com/developers/postbin/123

Assinar

O ponto de extremidade PubSubHubbub do GitHub é: https://api.github.com/hub. Uma solicitação bem-sucedida com o curl parece como:

curl -u "user" -i \
  https://api.github.com/hub \
  -F "hub.mode=subscribe" \
  -F "hub.topic=https://github.com/{owner}/{repo}/events/push" \
  -F "hub.callback=https://www.toptal.com/developers/postbin/123"

Solicitações do PubSubHubbub podem ser enviadas várias vezes. Se o hook já existe, ele será modificado de acordo com a solicitação.

Parâmetros

Nome	Tipo	Descrição
`hub.mode`	`string`	Obrigatório. `subscribe` ou `unsubscribe`.
`hub.topic`	`string`	Obrigatório. A URI do repositório do GitHub a ser assinada. O caminho precisa estar no formato `/{owner}/{repo}/events/{event}`.
`hub.callback`	`string`	A URI para receber as atualizações do tópico.
`hub.secret`	`string`	Uma chave de segredo compartilhado que gera uma assinatura de hash do conteúdo de saída do texto. Você pode verificar se um push veio do GitHub comparando o corpo bruto da solicitação com o conteúdo de `X-Hub-Signature` ou `X-Hub-Signature-256` cabeçalhos. Veja a documentação do PubSubHubbub para obter mais detalhes.