Simular un webhook push de GitHub

Un mock GET con forma de evento push de GitHub, con un commit en refs/heads/main.

Esta plantilla devuelve un evento push con forma de GitHub con un commit en refs/heads/main, para que puedas desarrollar un activador de CI o un controlador de bot sin tener que enviar a un repositorio real. Lleva los campos en los que la mayoría de los controladores realmente se dividen (ref, after y el nombre del repositorio) y omite el encabezado de firma, por lo que ejercita tu análisis en lugar de tu verificación.

Devuelve un evento listo para usar: aliméntalo directamente en tu propio controlador.

Payload de respuesta

{
  "ref": "refs/heads/main",
  "before": "a10867b14bb761a232cd80139fbd4c0d33264240",
  "after": "b7e1a2c3d4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9",
  "repository": {
    "full_name": "octocat/quickmock-demo"
  },
  "pusher": {
    "name": "octocat"
  },
  "commits": [
    {
      "id": "b7e1a2c3d4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9",
      "message": "fix: handle empty payload",
      "timestamp": "2024-05-01T12:00:00Z"
    }
  ]
}

Campos que vale la pena conocer

Crear el mock

curl -X POST https://quickmock.dev/api/mocks \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "GET",
  "response_status": 200,
  "content_type": "application/json",
  "response_body": "{\"ref\":\"refs/heads/main\",\"before\":\"a10867b14bb761a232cd80139fbd4c0d33264240\",\"after\":\"b7e1a2c3d4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9\",\"repository\":{\"full_name\":\"octocat/quickmock-demo\"},\"pusher\":{\"name\":\"octocat\"},\"commits\":[{\"id\":\"b7e1a2c3d4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9\",\"message\":\"fix: handle empty payload\",\"timestamp\":\"2024-05-01T12:00:00Z\"}]}"
}'

Llamarlo

curl https://quickmock.dev/m/<slug>

Lo que obtienes

GET /m/<slug> -> 200 a GitHub-style push event
one commit on refs/heads/main

En qué se diferencia de la realidad

Esta es una única confirmación estática en lugar del conjunto completo de campos que lleva un evento push real: sin encabezado X-Hub-Signature-256, sin remitente o head_commit, sin URL de comparación.

Fuentes

• GitHub: the push event payload
• GitHub: validating webhook deliveries

Preguntas frecuentes

¿Es este un webhook real de GitHub?

No. Es un único commit estático servido desde tu URL mock, sin el encabezado X-Hub-Signature-256, el remitente, el head_commit o la URL de comparación que lleva un evento push real.

¿Cómo pruebo un envío a una rama diferente?

Cambia ref en el cuerpo de la respuesta — por ejemplo a refs/heads/release. El filtrado de sucursales es el fragmento de lógica más común en un controlador push y el más fácil de estropear.

¿Puedo usarlo para probar etiquetas o eventos de eliminación?

Solo editando el cuerpo para que coincida con esos payloads, que difieren en forma. Para un manejador que se distribuye según el tipo de evento, crea un mock por evento para que cada caso tenga su propia URL estable.

Combina bien con esta guía: Probar un receptor de webhook

Plantillas relacionadas

• Simular el desafío de la API de eventos de Slack Un mock POST que responde al apretón de manos url_verification de Slack haciendo eco del valor del desafío.
• Simular un webhook de bot de Telegram Un mock POST que responde a una Actualización de Telegram con una llamada a sendMessage de vuelta al mismo chat.
• Simular un payload de webhook de Stripe Un mock GET que devuelve un evento payment_intent.succeeded con forma de Stripe, listo para alimentar tu controlador de webhook.

← Todas las plantillas

Última actualización: 2026-10-17