Webhooks

Los webhooks le permitirán recibir notificaciones en tiempo real cuando ocurran ciertos eventos. Por ejemplo:

• Es posible que los sistemas que no sean responsables directamente de realizar una solicitud para la API, también deban conocer la respuesta a dicha solicitud. ¿Cómo se les puede comunicar dicha respuesta?
• Algunos eventos de PrintNode, como los cambios del estado conectado de una computadora, no son el resultado de una solicitud directa para la API. ¿Cómo puede saber cuándo ocurren dichos eventos?
• Se pueden devolver múltiples eventos desde una sola llamada directa a la API, durante un período extendido de tiempo, p. ej., durante los diferentes estados por los que progresa un trabajo de impresión (PrintJob), a medida que lo recibe el Servidor, se publica para un Cliente, se ejecuta y se termina. No es factible que una solicitud simultánea de la API tenga que esperar para poder recibir todas las respuestas. ¿Cómo se podrían escuchar de forma eficiente?

Los webhooks resuelven estos problemas, permitiéndole registrar una URL a la cual PrintNode notificará cada vez que ocurran ciertos eventos. Cuando ocurra un evento, PrintNode hará una petición HTTP a la URL, proporcionando todos los datos necesarios sobre el evento en el cuerpo de la petición.

Algunos casos típicos en los que se usan webhooks:

• El seguimiento, en tiempo real, del estado conectado o desconectado de sus computadoras.
• La confirmación de que sus documentos hayan sido descargados e impresos con éxito.
• El control de la actividad de sus cuentas de PrintNode.

Los webhooks son mucho más eficientes que las meras consultas dirigidas hacia la API HTTP. En lugar de perder el tiempo con miles de solicitudes por hora, solo tendrá que recibir una notificación siempre que ocurra un evento en el que esté interesado. La latencia y el uso del ancho de banda se reducen drásticamente, por lo que es mucho menos probable que se tope con el límite de velocidad de la API.

Podrá crear y administrar los webhooks a través de la aplicación web de PrintNode o a través de nuestra API.