Sobre eventos y cargas de webhook
Puedes crear webhooks que se suscriban a los eventos listados en esta página. Para limitar el número de solicitudes HTTP al servidor, solo debes suscribirte a los eventos específicos que planees controlar. Para más información, consulta Crear webhooks.
Cada evento webhook en esta página incluye una descripción de las propiedades del webhook para ese evento. Si el evento tiene varias acciones, se incluyen las propiedades correspondientes a cada acción.
Cada evento solo está disponible para tipos específicos de webhooks. Por ejemplo, un webhook de organización puede suscribirse al evento team, pero un webhook de repositorio no puede. La descripción de cada evento de webhook enumera la disponibilidad de ese evento. Para más información, consulta Tipos de webhooks.
La propiedad sender
La mayoría de las cargas de webhook incluyen una sender propiedad que identifica al usuario que desencadenó el evento. A veces, GitHub no puede identificar a un usuario específico, por ejemplo, cuando un evento proviene de un proceso interno en lugar de una persona, o cuando la acción que lo desencadena no tiene asociado ningún usuario. Para algunos eventos, como check_run y check_suite, esto incluye acciones sin un push de Git ni un actor de API autenticado.
En estos casos, sender se rellena con el usuario ghost, una cuenta de marcador de posición cuya login es ghost y cuyo id no está vinculado a ningún usuario real vigente. No asuma que sender siempre identifica a la persona que causó un evento, y tenga en cuenta al usuario ghost en cualquier lógica de negocio o de seguridad que dependa de ello.
Límite de carga útil
Las cargas se limitan a 25 MB. Si un evento genera una carga mayor, GitHub no entregará una carga para ese evento de webhook. Esto puede pasar, por ejemplo, en un evento create si se insertan muchas ramas o etiquetas al mismo tiempo. Te sugerimos monitorear el tamaño de tu carga útil para garantizar la entrega.
Encabezados de entrega
Las cargas útiles de HTTP POST que se entregan a la terminal URL configurada para tu webhook contendrán varios encabezados especiales:
X-GitHub-Hook-ID: identificador único del webhook.