Tech

Canlı API sözleşmem neden yalnızca CI hattımın göremediği şekillerde bozuluyor?

Fırsat

Tüketici güdümlü sözleşme testi, birleştirme öncesinde kırıcı değişiklikleri yakalar; ancak sözleşmeleri PR anında sabitler ve dağıtım sonrasında canlı bir hizmette biriken anlamsal kayışı tespit etme mekanizmasından yoksundur. Ekipler, üretim acil yamalarında belgelenmemiş alanlar ekler, bir olayın önünü açmak için hata şekillerini değiştirir ya da OpenAPI spesifikasyonuna dokunmadan doğrulamayı gevşetir. World Quality Report 2025, tespit edilemeyen API şema kayışını dağıtık sistemlerdeki üretim olaylarının en önemli üç nedeni arasında göstermekte ve üretimde yaşanan API başarısızlıklarının yaklaşık yüzde 70'inin tüm CI kontrollerini geçtiğini tahmin etmektedir. Mevcut hiçbir araç, gerçek üretim trafiğini yayımlanmış bir sözleşmeye karşı sürekli olarak izlemez ve ihlalleri birleştirme anında değil birikim anında yüzeye çıkarmaz.

Neden önemli

Gerçek canlı trafiği yayımladığınız sözleşmeye karşı izlemek, API'nizin vaat ettiği ile sessizce sunmayı bıraktığı arasındaki son mesafeyi kapatır.

Fırsatı nasıl puanlıyorum

Fırsat Puanı benim kendi değerlendirmem, bir ölçüm değil: ne kadar acı verdiği, ne sıklıkla etkisi olduğu ve bugün için ne kadar az çözüm bulunduğu. Daha yüksek puan, inşa etmeye daha değer olduğunu düşündüğüm anlamına gelir.

Ciddiyet8/10

Ortaya çıktığında ne kadar sorun yarattığı.

Sıklık8/10

İnsanların bununla gerçekte ne sıklıkla karşılaştığı.

Boşluk7/10

Bugün bunun için ne kadar az iyi araç bulunduğu.