Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Configurar un webhook para que te notifique sobre los cambios de plan

Después de crear un listado de Mercado GitHub en borrador, puedes configurar un webhook que te notifique cuando sucedan cambios en los planes de la cuenta de los clientes. Después de que configures el webhook, puedes gestionar los tipos de evento de marketplace_purchase en tu app.

En este artículo

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/json entregará la carga útil de JSON directametne como el cuerpo de la solicitud POST.
  • El tipo de contenido application/x-www-form-urlencoded enviará la carga útil de JSON como un parámetro de forma llamado payload.

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.

Inspeccionar las entregas de webhooks de Mercado GitHub recientes

¿Te ayudó este documento?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.