{"schema_version":"1.0","type":"Article","canonical_url":"https://visteesto.com/nota/que-es-webhook-diferencia-api","machine_urls":{"markdown":"https://visteesto.com/ai/article/que-es-webhook-diferencia-api/markdown","json":"https://visteesto.com/ai/article/que-es-webhook-diferencia-api/json"},"publisher":{"name":"VisteEsto","url":"https://visteesto.com","editor":"Martín Rodríguez","editorial_policy":"https://visteesto.com/politica-editorial","corrections_policy":"https://visteesto.com/correcciones"},"headline":"Qué es un webhook y en qué se diferencia de una API","description":"Qué es un webhook y en qué se diferencia de una API: envía avisos HTTP cuando ocurre un evento, sin consultar el servicio repetidamente.","dek":"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.","language":"es","section":"Tecnología","topic":"webhooks-programacion","tags":["Webhooks","API","Programación","Desarrollo web"],"author":{"name":"Martin Rodriguez","profile_url":"https://visteesto.com/autor/martin-rodriguez"},"date_published":"2026-09-18T12:00:00.000Z","date_modified":"2026-09-18T12:00:00.000Z","search_intent":"explain","content_format":"brief","primary_query":"qué es un webhook y en qué se diferencia de una API","intended_audience":"Personas que empiezan a integrar servicios web o necesitan elegir entre consultar una API y recibir eventos.","original_contribution":"VisteEsto combina tres documentaciones oficiales en una comparación operativa y una cadena visual de recepción segura.","key_facts":[{"statement":"Un webhook entrega datos automáticamente a una URL cuando ocurre un evento suscripto.","evidence_url":"https://docs.github.com/en/webhooks/about-webhooks"},{"statement":"Consultar una API periódicamente requiere que la aplicación pregunte si hay datos nuevos.","evidence_url":"https://docs.github.com/en/webhooks/about-webhooks"},{"statement":"Stripe exige verificar la firma sobre el cuerpo original y recomienda responder 2xx antes del trabajo complejo.","evidence_url":"https://docs.stripe.com/webhooks"},{"statement":"GitLab recomienda receptores rápidos y preparados para posibles eventos duplicados.","evidence_url":"https://docs.gitlab.com/user/project/integrations/webhooks/"}],"sections":[{"heading":"Qué es un webhook y cómo entrega un evento","paragraphs":["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."]},{"heading":"Webhook o consulta periódica a una API","paragraphs":["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."]},{"heading":"La cadena segura para recibir un webhook","paragraphs":["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."]}],"sources":[{"name":"GitHub Docs: About webhooks","url":"https://docs.github.com/en/webhooks/about-webhooks","kind":"primary"},{"name":"Stripe Docs: Receive events in a webhook endpoint","url":"https://docs.stripe.com/webhooks","kind":"primary"},{"name":"GitLab Docs: Webhooks","url":"https://docs.gitlab.com/user/project/integrations/webhooks/","kind":"primary"}],"primary_source_gap":null,"images":[{"url":"https://visteesto.com/media/que-es-webhook-diferencia-api/cover.jpg","alt":"Un evento viaja mediante un webhook hacia una aplicación","width":1200,"height":675,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/que-es-webhook-diferencia-api","caption":"El webhook lleva un evento desde el servicio emisor hasta una URL receptora."},{"url":"https://visteesto.com/media/que-es-webhook-diferencia-api/inline-1.jpg","alt":"Comparación entre consultas periódicas a una API y un webhook","width":1200,"height":800,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/que-es-webhook-diferencia-api","caption":"La consulta periódica pregunta; el webhook entrega cuando ocurre el evento."},{"url":"https://visteesto.com/media/que-es-webhook-diferencia-api/inline-2.jpg","alt":"Cadena de validación y procesamiento seguro de un webhook","width":1200,"height":675,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/que-es-webhook-diferencia-api","caption":"Verificar, deduplicar, encolar y responder rápido reduce errores en la recepción."}],"videos":[],"update_log":[{"date":"2026-09-18T12:00:00.000Z","note":"Publicación inicial basada en las documentaciones oficiales de GitHub, Stripe y GitLab."}],"citation_guidance":{"preferred_url":"https://visteesto.com/nota/que-es-webhook-diferencia-api","include":["headline","author","date_published_or_modified","preferred_url"]}}