| Caractéristique | API | Webhook |
|---|---|---|
| Initiateur de la communication | API Le client (l'application qui fait la requête) | Webhook Le serveur (l'application qui envoie la notification) |
| Modèle de flux de données | API Pull (Tirage) – Le client demande activement les données ou l'exécution d'une action. | Webhook Push (Poussée) – Le serveur envoie les données automatiquement lorsqu'un événement se produit. |
| Réactivité | API Nécessite une interrogation (polling) ou une demande explicite pour obtenir les dernières informations. | Webhook En temps réel, dès qu'un événement survient, sans besoin d'interrogation. |
| Exemple d'usage | API Récupérer la météo actuelle, publier un tweet, effectuer un paiement en ligne. | Webhook Recevoir une alerte pour une nouvelle commande, une notification de modification de fichier, un message de chat. |
Une API (Application Programming Interface) est un ensemble de règles et de définitions permettant à deux applications logicielles de communiquer entre elles. Elle définit comment une application peut interroger une autre application pour demander des services ou des informations.
Un Webhook est un mécanisme par lequel une application peut envoyer des notifications ou des données en temps réel à une autre application lorsqu'un événement spécifique se produit. Il agit comme un "appel inverse" ou un rappel automatique.
Avec une API, c'est toi qui vas chercher l'information à la bibliothèque quand tu en as besoin. Avec un Webhook, c'est la bibliothèque qui t'appelle directement pour te dire qu'un nouveau livre est arrivé ou que ta commande est prête, sans que tu aies à demander.
Historiquement, la confusion entre API et Webhook vient surtout de l'évolution des systèmes informatiques et de la manière dont les applications échangent de l'information. À l'origine, une API (Application Programming Interface) était simplement un ensemble de règles permettant à deux logiciels de communiquer, un peu comme un menu de restaurant où tu choisis ce que tu veux commander (tu "tires" l'information). Le concept d'API est très large. Avec l'avènement des services web modernes (les fameuses API REST), l'idée de "faire une requête" pour obtenir des données est devenue la norme. Les Webhooks, eux, sont apparus comme une réponse à un besoin de réactivité en temps réel. Ils ne sont pas une alternative, mais une méthode de communication spécifique qui s'inscrit dans l'écosystème API, où c'est le serveur qui te "pousse" l'information, créant une nuance qui prête à confusion.
Imagine que tu veuilles connaître la météo actuelle de Paris. Tu ouvres une application météo sur ton téléphone. En coulisses, cette application ne "sait" pas directement quel temps il fait. Elle envoie une requête (un appel à une API) à un service météorologique externe en lui demandant : "Donne-moi la météo pour Paris maintenant". Le service météo reçoit ta demande, cherche l'information et te renvoie les données (température, pluie, vent). Ton application affiche alors ces informations. C'est toi qui initie la conversation, tu "tires" l'information quand tu en as besoin.
Imagine que tu veuilles être notifié instantanément quand un colis change de statut. Plutôt que de rafraîchir la page de suivi (comme une API pour "tirer" l'info), tu configures une alerte. Dès que le service de livraison détecte un événement (colis expédié, livré), il ne t'attend pas : il "pousse" directement l'information vers l'adresse que tu as fournie. C'est le principe du Webhook : le système t'informe proactivement d'un événement important, sans que tu aies besoin de le solliciter continuellement.