¿Qué es un Webhook (API)?
Definición breve: Un webhook es una notificación HTTP que un servicio envía a tu endpoint cuando ocurre un evento (por ejemplo, “pago completado” o “issue creada”).
Ejemplo rápido
// Ejemplo en Node.js (Express) recibiendo un webhook
app.post('/webhooks/pagos', express.json(), (req, res) => {
const evento = req.body;
// 1) Validar firma del proveedor (cabecera)
// 2) Procesar el evento (idempotencia: evita duplicados)
// 3) Responder 2xx rápidamente
res.sendStatus(200);
});
¿Por qué importa?
Permiten integraciones reactivas sin polling continuo, reduciendo latencia y consumo. Debes implementar verificación de firma, reintentos y idempotencia para que el sistema sea robusto.
Mini-FAQ
¿Qué pasa si mi servidor está caído?
Muchos proveedores reintentan varias veces. Implementa colas y registros para re-procesar cuando vuelva el servicio.
¿Cómo valido que el webhook es auténtico?
Los proveedores envían una firma (HMAC) en cabeceras. Recalcula la firma con tu secret y compárala de forma constante.
