Webhook
Un webhook es un mensaje automático que un sistema envía de inmediato, cuando ocurre un evento concreto, a una dirección de internet registrada de antemano. Así, otro sistema se entera sin preguntar constantemente de que, por ejemplo, ha entrado un pedido o se ha pagado una factura.
Explicación
En una consulta clásica a una API, su programa pregunta con regularidad: «¿Hay pedidos nuevos?» Esa pregunta repetida se llama polling. Un webhook lo invierte. En el sistema de origen usted registra una dirección y elige los eventos que le interesan. Cuando ocurre uno, el sistema envía a esa dirección una solicitud HTTP con los datos principales.
Los webhooks son rápidos y ahorran solicitudes. Pero tienen sus particularidades: si el receptor no está disponible en ese momento, un mensaje puede perderse o llegar de nuevo más tarde. Por eso una interfaz fiable comprueba el origen de cada mensaje, detecta las repeticiones y, además, concilia a intervalos fijos mediante la API si falta algo.
Ejemplo del día a día con interfaces
Una tienda envía un webhook a la interfaz con cada pedido pagado. Esta obtiene mediante la API los datos completos del pedido y crea el encargo en la gestión de mercancías. Si por una avería el webhook no llega a la interfaz, una conciliación nocturna encuentra el pedido que falta y lo transfiere después. El mismo pedido no se crea dos veces.
Diferencias con términos relacionados
- API: su programa consulta de forma activa. En el webhook, el otro sistema avisa por sí mismo. En la práctica se combinan ambos.
- Polling: consulta periódica mediante la API. Más sencillo, pero más lento y con más solicitudes.
- Interfaz: el término general para toda la conexión, de la que un webhook puede formar parte.
Relación con nuestros servicios
Cuando un sistema ofrece webhooks, los usamos para transferencias rápidas y los respaldamos con una conciliación periódica. Supervisamos en la operación si los webhooks llegan y se procesan. Más sobre el procedimiento en Encargar la programación de una interfaz.
Preguntas frecuentes
¿Un webhook es tiempo real?
Casi. El mensaje sale normalmente unos instantes después del evento. Pero un webhook por sí solo no es una garantía de entrega.
Relacionado
API
Una API es una interfaz de programación definida con la que un software usa datos y funciones de otro sistema. Explicación, ejemplo y diferencias.
Interfaz
Una interfaz conecta dos sistemas para que intercambien datos automáticamente. Definición, ejemplo del día a día y diferencias con API y middleware.
Operación y monitorización
Alojamiento en Alemania, monitorización, alertas y aviso si cambian las API. Cancelable cada mes.
