Webhook y API: quién llama a quién
- Con una API, tu sistema pregunta: «¿hay pedidos nuevos?». Si pregunta cada cinco minutos, o se entera tarde o casi siempre pregunta en vano.
- Con un webhook, el otro sistema avisa: «acaba de entrar este pedido». El aviso llega en el momento y solo cuando hay algo.
Se usan juntos: el webhook avisa de que algo ha pasado y, si hace falta más detalle, se pide por la API.
Un ejemplo
Tu tienda online recibe un pedido con instalación. Su webhook avisa a tu sistema de gestión, que crea la orden y la pone en la agenda del técnico. Cuando el técnico cierra el trabajo, un webhook de salida avisa a la tienda para que marque el pedido como instalado.
De entrada y de salida
Un webhook de entrada es la dirección donde tu sistema recibe los avisos de otros. Uno de salida es el aviso que tu sistema envía a otros cuando algo cambia dentro.
El error habitual
No guardar lo que se envió. Si el sistema que recibe está caído, el aviso se pierde y nadie se entera. Un webhook bien montado guarda el historial de envíos, permite reenviar lo que falló y protege lo que envía.