Skip to content
Tech

Perché il mio contratto API in produzione si rompe solo nei modi che la mia pipeline CI non riesce a vedere?

81

Opportunità

Il contract testing basato sul consumatore intercetta le modifiche che rompono la compatibilità prima del merge, ma fissa i contratti al momento della PR e non dispone di alcun meccanismo per rilevare la deriva semantica che si accumula in un servizio attivo dopo il deployment. I team aggiungono campi non documentati nelle hotfix di produzione, modificano la struttura degli errori per sbloccare un incidente, o allentano la validazione senza toccare la specifica OpenAPI. Il World Quality Report 2025 indica la deriva non rilevata degli schema API come una delle prime tre cause di incidenti in produzione nei sistemi distribuiti, e stima che circa il 70 percento dei fallimenti API in produzione abbia superato tutti i controlli CI. Nessuno strumento attuale monitora continuamente il traffico reale in produzione rispetto a un contratto pubblicato e segnala le violazioni man mano che si accumulano, anziché al momento del merge.

Perché è importante

Monitorare il traffico reale in produzione rispetto al contratto pubblicato chiuderebbe l'ultimo miglio tra ciò che la tua API promette e ciò che ha smesso silenziosamente di consegnare.

Come valuto l'opportunità

L'Opportunity Score è la mia valutazione personale, non una misurazione: quanto fa male, con quale frequenza colpisce e quanto poco esiste per risolverlo oggi. Un punteggio più alto significa che lo ritengo più degno di essere sviluppato.

Gravità8/10

Quanto dolore provoca quando si manifesta.

Frequenza8/10

Quanto spesso le persone ci si imbattono davvero.

Spazio bianco7/10

Quanti pochi strumenti validi esistono oggi per affrontarlo.

Altri problemi che vale la pena risolvere