Configurar um webhook para notificá-lo de alterações de plano

Depois de criar uma listagem de rascunho de GitHub Marketplace, você pode configurar um webhook que notifique quando ocorrerem alterações nos planos da conta do cliente. Depois de configurar o webhook, você pode lidar com os tipos de eventos do marketplace_purchase em seu aplicativo.

Neste artigo

Note

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ção POST.
  • O tipo de conteúdo application/x-www-form-urlencoded envia o conteúdo JSON como um parâmetro de formulário chamado payload.

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. 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.

Captura de tela das entregas recentes do webhook para a listagem do GitHub Marketplace.