À quoi servent les webhooks ?
Les webhooks servent généralement à connecter deux applications différentes. Lorsqu’un événement se produit dans l’application déclencheuse, celle-ci sérialise les données relatives à cet événement et les envoie à l’URL de webhook de l’application d’action, c’est-à-dire celle qui doit effectuer une opération à partir des données de la première application.
(Le terme webhook désigne généralement la publication d’un événement vers un autre système via le web, au moyen d’une API. Les webhooks utilisent des messages HTTP POST pour déclencher des actions dans une autre application lorsqu’un événement survient. Le format de données standard actuel est le JSON, mais il est possible de créer un système de webhooks à partir d’événements SMS ou SMTP.)
Webhook ou API
Une API est un messager qui transmet votre requête au fournisseur concerné, puis vous renvoie sa réponse. Le webhook, également appelé API inversée, rappel web (web callback) ou API HTTP push, permet quant à lui à une application de fournir des informations en temps réel à d’autres applications.
Il existe deux différences essentielles entre les API et les webhooks : qui les appelle, et dans quel sens circulent les informations.
Avec une API, c’est vous qui êtes à l’origine de la connexion. Par exemple, vous apportez une modification au service ou vous interrogez le service pour obtenir une mise à jour. Avec un webhook, c’est le service qui est à l’origine de la connexion : lorsque la mise à jour se produit, c’est lui qui vous appelle (ou appelle un autre service). C’est particulièrement important lorsque vos actions dépendent d’événements survenant sur le service et que vous souhaitez en être informé dès qu’ils se produisent.
Avec une API, les données circulent dans les deux sens : vous pouvez envoyer des données au service et en recevoir. Avec un webhook, le flux est unidirectionnel : vous recevez uniquement les données du service.
Notez que les API et les webhooks peuvent être utilisés simultanément. Par exemple, lorsque vous recevez un appel webhook du service (indiquant un événement spécifique), vous pouvez utiliser l’API pour renvoyer au service une mise à jour concernant cet événement.