Skip to content
Tech

Why does my live API contract only break in ways my CI pipeline cannot see?

81

Opportunity

Consumer-driven contract testing catches breaking changes before merge, but it pins contracts at PR time and has no mechanism to detect semantic drift that accumulates in a live service after deployment. Teams add undocumented fields in production hotfixes, change error shapes to unblock an incident, or relax validation without touching the OpenAPI spec. The World Quality Report 2025 names undetected API schema drift a top-three cause of production incidents in distributed systems, and estimates roughly 70 percent of API failures in production passed all CI checks. No current tool continuously monitors real production traffic against a published contract and surfaces violations as they accumulate rather than at merge time.

Why it matters

Watching actual live traffic against the contract you published would close the last mile between what your API promises and what it silently stopped delivering.

How I score the opportunity

The Opportunity Score is my own read, not a measurement: how much it hurts, how often it bites, and how little exists to solve it today. Higher means I think it is more worth building.

Severity8/10

How much pain it causes when it shows up.

Frequency8/10

How often people actually run into it.

Whitespace7/10

How little good tooling exists for it today.

More problems worth solving