Webhook

Webhook : Appel HTTP émis par un service tiers vers un serveur pour signaler un événement, ce qui évite d’interroger son API en permanence.

Ce terme appartient à la famille « Technique ». La page reprend l’essentiel : à quoi ça sert, comment l’écrire, ce qui se passe quand on l’oublie.

À quoi sert Webhook

Webhook se manifeste quand le réseau est mauvais, quand la charge monte ou quand l’application tourne en arrière-plan. Ce sont exactement les moments qu’une recette en salle de réunion ne reproduit pas.

Le sujet se présente rarement seul. Il arrive au milieu d’une décision plus large, et c’est à ce moment qu’il faut savoir de quoi on parle.

La traduction en exigences

Un cahier des charges sérieux relie « Webhook » à un critère de recette : une phrase que l’on peut cocher ou refuser, pas une intention.

À écrire noir sur blanc, dans le chapitre qui correspond :

• Les intégrations tierces, nommées, avec leur documentation et leurs limites d’appel.
• La sauvegarde des données : fréquence, durée de rétention, restauration réellement testée.
• La supervision : quelles alertes, vers qui, sous quel délai d’intervention.
• Le sort des données à la fin du contrat, format d’export compris.

Rien n’oblige à tout figer dès le premier jour. Ce qui reste ouvert doit alors être signalé comme tel, avec la date à laquelle la décision sera prise.

Le modèle de cahier des charges du guide reprend ces rubriques dans l’ordre attendu par une agence, et la grille de lecture des devis montre à quoi ressemble un chiffrage comparable.

Les contrôles à prévoir

Webhook se vérifie en conditions dégradées, pas en conditions idéales. C’est là que les écarts apparaissent.

• Couper le réseau en pleine utilisation et regarder ce que l’application affiche.
• Tester sur une connexion lente, pas seulement sur le Wi-Fi du bureau.
• Lire les journaux d’erreurs de la première semaine de production.

Ce qui n’est pas vérifié à la recette ne sera pas vérifié du tout : le jour de la mise en ligne, plus personne n’a le temps.

Ce qui tourne mal le plus souvent

Sur ce point précis, voici ce qui coûte le plus cher aux porteurs de projet, dans l’ordre où on le rencontre.

• Dimensionner l’infrastructure sur le trafic du lancement et non sur celui d’une campagne.
• Considérer les sauvegardes comme faites parce qu’elles sont configurées, sans tester de restauration.
• Découvrir les coûts d’hébergement après la mise en ligne, faute de les avoir demandés au devis.
• Mesurer la performance sur un téléphone récent et l’annoncer comme celle du parc réel.
• Ne relier le sujet à aucun critère de recette : ce qui ne se vérifie pas ne se livre pas.

Termes liés

Les entrées du glossaire déjà publiées sur des sujets voisins :

• Gestionnaire de mots de passe
• API REST
• Notification push
• Lien profond
• Feature flag

Questions fréquentes

Que signifie « Webhook » ?

Appel HTTP émis par un service tiers vers un serveur pour signaler un événement, ce qui évite d’interroger son API en permanence. La définition tient en une phrase, son application dépend du projet. C’est pour cette raison qu’elle doit figurer dans le cahier des charges plutôt que dans un échange de courriels.

Le sujet doit-il apparaître dans le devis ?

Oui, sous un poste identifiable. Un devis qui fond conception, développement, tests et exploitation dans une ligne unique ne permet ni de comparer, ni de discuter, ni de couper.

Comment savoir si le budget annoncé est cohérent ?

En comparant le périmètre écrit aux fourchettes constatées en France, détaillées poste par poste sur le guide des prix. Un chiffre isolé ne veut rien dire sans le périmètre qui va avec.

Toutes les définitions publiées sont rassemblées dans l’index du glossaire, classées de A à Z et par famille.