# Qué es un webhook y en qué se diferencia de una API

> Un webhook lleva un evento desde un servicio hasta una URL configurada. La aplicación receptora debe verificar su origen, tolerar duplicados y procesarlo sin demorar la respuesta.

- URL canónica: https://visteesto.com/nota/que-es-webhook-diferencia-api
- Autor: [Martin Rodriguez](https://visteesto.com/autor/martin-rodriguez)
- Publicado: 2026-09-18T12:00:00.000Z
- Actualizado: 2026-09-18T12:00:00.000Z
- Sección: Tecnología
- Tema: webhooks-programacion
- Idioma: es
- Consulta principal: qué es un webhook y en qué se diferencia de una API

## Resumen verificable

- Un webhook entrega datos automáticamente a una URL cuando ocurre un evento suscripto. ([evidencia](https://docs.github.com/en/webhooks/about-webhooks))
- Consultar una API periódicamente requiere que la aplicación pregunte si hay datos nuevos. ([evidencia](https://docs.github.com/en/webhooks/about-webhooks))
- Stripe exige verificar la firma sobre el cuerpo original y recomienda responder 2xx antes del trabajo complejo. ([evidencia](https://docs.stripe.com/webhooks))
- GitLab recomienda receptores rápidos y preparados para posibles eventos duplicados. ([evidencia](https://docs.gitlab.com/user/project/integrations/webhooks/))

## Aporte editorial de VisteEsto

VisteEsto combina tres documentaciones oficiales en una comparación operativa y una cadena visual de recepción segura.

## Qué es un webhook y cómo entrega un evento

Un webhook es un mecanismo para que un sistema avise a otro cuando ocurre un evento. Al configurarlo se registra una URL y se eligen los eventos de interés. Cuando sucede uno, el emisor envía una solicitud HTTP con datos a esa dirección para que la aplicación receptora actúe.

GitHub, por ejemplo, permite recibir entregas cuando se abre una solicitud de cambios o se envía código. Stripe usa endpoints HTTPS para eventos asíncronos como la confirmación de un pago. El contenido y los encabezados varían según el proveedor: JSON es habitual, pero no define por sí solo a un webhook.

## Webhook o consulta periódica a una API

La diferencia práctica está en quién inicia el intercambio. Con una consulta periódica, la aplicación pregunta a una API cada cierto tiempo si apareció información nueva. Con un webhook, el servicio emisor inicia la entrega cuando detecta el evento. Así puede reducir consultas innecesarias y acercar la actualización al momento en que ocurre.

Una API sigue siendo útil para pedir información bajo demanda, recuperar el estado actual o ejecutar una acción. Un webhook no suele reemplazarla: notifica que algo cambió y la aplicación puede usar la API después para ampliar o confirmar datos. Además, el receptor debe estar disponible en una URL accesible para recibir la entrega.

## La cadena segura para recibir un webhook

La secuencia recomendable es recibir el cuerpo sin modificar, comprobar la firma con el secreto del proveedor, validar el tipo de evento y registrar un identificador antes de procesarlo. Stripe advierte que la verificación necesita el cuerpo original de la solicitud y recomienda responder con un código 2xx antes de ejecutar tareas complejas.

Después de validar, conviene enviar el trabajo a una cola y usar el identificador del evento para ignorar repeticiones. GitLab recomienda receptores rápidos, contempla eventos duplicados y reenvíos con la misma clave de idempotencia. La regla concreta depende del proveedor: hay que leer su documentación sobre firmas, reintentos, orden y tiempos límite.

## Fuentes consultadas

- Fuente primaria: [GitHub Docs: About webhooks](https://docs.github.com/en/webhooks/about-webhooks)
- Fuente primaria: [Stripe Docs: Receive events in a webhook endpoint](https://docs.stripe.com/webhooks)
- Fuente primaria: [GitLab Docs: Webhooks](https://docs.gitlab.com/user/project/integrations/webhooks/)

## Imágenes y licencias

- Un evento viaja mediante un webhook hacia una aplicación. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/que-es-webhook-diferencia-api).
- Comparación entre consultas periódicas a una API y un webhook. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/que-es-webhook-diferencia-api).
- Cadena de validación y procesamiento seguro de un webhook. Autor: VisteEsto. Licencia: [VisteEsto editorial](https://visteesto.com/terminos). [Origen](https://visteesto.com/que-es-webhook-diferencia-api).

## Cómo citar

Citar título, autor, fecha de publicación o actualización y la URL canónica. Las afirmaciones centrales incluyen su evidencia directa arriba. Esta versión Markdown es una representación accesible; la nota HTML canónica es la fuente editorial de referencia.