Skip to content
Tech

Pourquoi mon contrat d'API en production ne se brise-t-il que de façons que mon pipeline CI ne peut pas détecter ?

81

Opportunité

Les tests de contrat pilotés par le consommateur détectent les changements incompatibles avant la fusion, mais ils figent les contrats au moment de la pull request et n'ont aucun mécanisme pour détecter la dérive sémantique qui s'accumule dans un service en production après le déploiement. Les équipes ajoutent des champs non documentés dans des correctifs de production, modifient la structure des erreurs pour débloquer un incident, ou assouplissent la validation sans toucher à la spécification OpenAPI. Le World Quality Report 2025 identifie la dérive non détectée des schémas d'API comme l'une des trois principales causes d'incidents en production dans les systèmes distribués, et estime qu'environ 70 % des défaillances d'API en production ont passé tous les contrôles CI. Aucun outil actuel ne surveille en continu le trafic réel de production par rapport à un contrat publié et ne signale les violations au fur et à mesure qu'elles s'accumulent plutôt qu'au moment de la fusion.

Pourquoi c'est important

Surveiller le trafic réel en production par rapport au contrat que vous avez publié comblerait le dernier kilomètre entre ce que votre API promet et ce qu'elle a silencieusement cessé de fournir.

Comment j'évalue l'opportunité

Le Score d'Opportunité est mon évaluation personnelle, pas une mesure : l'intensité de la douleur, sa fréquence et le peu de solutions qui existent aujourd'hui. Plus il est élevé, plus je pense que le problème vaut la peine d'être résolu.

Gravité8/10

L'intensité de la douleur qu'il provoque lorsqu'il se manifeste.

Fréquence8/10

La fréquence à laquelle les gens y sont réellement confrontés.

Espace libre7/10

Le peu de bons outils qui existent pour y remédier aujourd'hui.

D'autres problèmes qui méritent d'être résolus