Webhooks

Les Webhooks vous permettent de recevoir des notifications en temps réel lorsque certains événements se produisent. Par exemple :

• Les systèmes qui ne sont pas directement responsables de la création d'une demande d'API peuvent tout de même avoir besoin de connaître la réponse à cette demande. Comment peuvent-ils être informés de celle-ci ?
• Certains événements liés à PrintNode, telles que les modifications apportées à l'état de connexion d'un ordinateur, ne résultent pas d'une demande d'API directe. Comment pouvez-vous savoir quand ces événements se produisent ?
• Plusieurs événements peuvent être renvoyés à partir d'un seul appel direct d'API sur une période prolongée, par ex. les différents états de progression d'une tâche d'impression à mesure qu’elle est reçue par le serveur, publiée sur un client, exécutée et terminée. Une requête d'API synchrone ne peut pas attendre de recevoir tous les réponses. Comment pouvez-vous faire cela efficacement ?

Les Webhooks résolvent ces problèmes en vous permettant d’enregistrer une adresse URL que PrintNode préviendra à chaque fois que certains événements surviennent. Lorsqu'un événement se produit, PrintNode envoie une requête HTTP à l'adresse URL, en fournissant toutes les données pertinentes à propos de l'événement dans le corps de la demande.

Certains cas d’utilisation typiques des Webhook incluent :

• Le suivi en temps réel de l'état connecté ou déconnecté de vos ordinateurs.
• Le confirmation que vos documents ont été téléchargés et imprimés avec succès.
• Le suivi de l'activité de vos comptes PrintNode.

Les Webhooks sont beaucoup plus efficaces que l'interrogation de l'API HTTP. Au lieu d'avoir recours à des milliers de demandes par heure, vous recevez simplement une notification pour chaque événement qui se produit. La latence et l’utilisation de la bande passante sont considérablement réduits et vous êtes beaucoup moins susceptible d'atteindre le seuil limite de l'API.

Vous pouvez créer et gérer des Webhooks par le biais de l’application Web PrintNode ou de l’API.