El webhook de evento de Mercado GitHub solo puede configurarse desde la página de listado de Mercado GitHub de tu aplicación. Puedes configurar el resto de los eventos desde la página de configuración del desarrollador de la aplicación. Si no has creado un listado de Mercado GitHub, lee la sección "Crear un borrador de listado de Mercado GitHub" para aprender cómo hacerlo.
Crear un webhook
Para crear un webhook para tu listado de Mercado GitHub, da clic en Webhooks en la barra lateral de tu página de listado de Mercado GitHub. Verás las siguientes opciones que se necesitan para configurar tu webhook:
URL de la carga útil
La URL de carga útil es la URL del servidor que recibirá las solicitudes de POST del webhook.
Tipo de contenido
Los webhooks pueden entregarse utilizando diferentes tipos de contenido:
- El tipo de contenido
application/jsonentregará la carga útil de JSON directametne como el cuerpo de la solicitudPOST. - El tipo de contenido
application/x-www-form-urlencodedenviará la carga útil de JSON como un parámetro de forma llamadopayload.
Elige el que se adapte mejor a tus necesidades. GitHub te recomienda utilizar el tipo de contenido application/json.
Secreto
Configurar el secreto de un webhook te permite garantizar que las solicitudes de POST que se envían a la URL de la carga útil vienen de GitHub. Cuando configuras un secreto, recibirás el encabezado de X-Hub-Signature en el la solicitud de POST del webhook. Para obtener más detalles sobre cómo utilizar el secreto y el encabezado de X-Hub-Signature para asegurar las cargas útiles de tu webhook, consulta la sección "Asegurar tus webhooks".
Activo
Predeterminadamente, las entregas de webhook están "Activas". También puedes elegir inhabilitar la entrega de cargas útiles de webhooks durante el desarrollo si deseleccionas "Activo". Si inhabilitaste las entregas de los webhooks, necesitarás seleccionar "Activo" antes de que emitas tu app para su revisión.
Visualizar las entregas de los webhooks
Una vez que hayas configurado tu webhook de Mercado GitHub, podrás inspecionar las cargas útiles de las solicitudes de tipo POST desde la página del Webhooks del listado de Mercado GitHub de tu aplicación. GitHub no reenvía los intentos fallidos de entrega. Asegúrate de que tu app pueda recibir toda la carga útil del webhook que envíe GitHub.
