Observação: este artigo se aplica somente à publicação de aplicativos do GitHub Marketplace. Para obter mais informações mais sobre como publicar o GitHub Actions no GitHub Marketplace, confira "Publicar ações no GitHub Marketplace".
O evento do webhook do GitHub Marketplace só pode ser configurado a partir da página de listagem GitHub Marketplace do seu aplicativo. Você pode configurar todos os outros eventos na página de configurações do desenvolvedor do aplicativo. Se você ainda não criou uma listagem de GitHub Marketplace, leia "Elaborar uma listagem para o seu aplicativo" para saber como.
Criando um webhook
Para criar um webhook para sua listagem do GitHub Marketplace, clique em Webhook na barra lateral esquerda da página de listagem do GitHub Marketplace. Você verá as seguintes opções de configuração de webhook necessárias para configurar seu webhook:
URL do conteúdo
A URL do conteúdo é a URL do servidor que receberá as solicitações POST
do webhook.
Tipo de conteúdo
Os webhooks podem ser entregues usando diferentes tipos de conteúdo:
- O tipo de conteúdo
application/json
fornecerá o conteúdo JSON diretamente como o corpo da solicitaçãoPOST
. - O tipo de conteúdo
application/x-www-form-urlencoded
envia o conteúdo JSON como um parâmetro de formulário chamadopayload
.
Selecione a mais adequada às suas necessidades. O GitHub recomenda usar o tipo de conteúdo application/json
.
Segredo
A definição de um segredo de webhook permite que você garanta que as solicitações POST
enviadas para a URL do conteúdo sejam provenientes do GitHub Enterprise Cloud. Quando você definir um segredo, receberá o cabeçalho X-Hub-Signature
e X-Hub-Signature-256
na solicitação POST
do webhook. Para obter mais informações sobre como usar um segredo com um cabeçalho de assinatura para proteger suas cargas de webhook, confira "Validação de entregas de webhooks".
Ativo
Por padrão, as entregas de webhook estão "Ativas". Você pode optar por desativar a entrega das cargas de webhook durante o desenvolvimento, desmarcando "Ativo". Se você desativou as entregas do webhook, será necessário selecionar "Ativo" antes de enviar seu aplicativo para revisão.
Visualizar entregas do webhook
Depois de configurar o webhook do GitHub Marketplace, você poderá inspecionar o conteúdo da solicitação POST
na página Webhook da listagem do GitHub Marketplace do aplicativo. O GitHub não reenvia tentativas de entrega com falha. Certifique-se de que seu aplicativo possa receber todas as cargas de webhook enviados pelo GitHub.