API Kontratları ile Microservice Senkronizasyonu

Bir backend ile frontend arasında WebSocket mesaj yapısı uyuşmazlığını debug etmek yarım günü alabilir. İkisi de haklı görünür: backend `{ticket_id, content}` gönderir, frontend başka bir şema bekler. Hiçbir crash olmaz, sadece sessizce yanlış veri işlenir.

Agent Graph Engineering, Part 3: Contracts, Not Conventions yazısında Huy Nguyen, bu sorunu kökünden çözmek için bir strateji sunuyor: şekli sunucuda bir kez tanımla, gerisi otomatik üret.

OpenAPI spesifikasyonundan TypeScript REST istemcisi, AsyncAPI'dan WebSocket istemcileri (TypeScript ve Python) derleyici tarafından oluştur. Artık iki sistem arasındaki sınırda elle bakım yapılmayan bir seam yok. Değişiklik yaptığında derleyici sana ne kırıldığını söyler; kullanıcı değil.

Aynı tanımlar onay formunu da oluşturur. Bir reviewer, gösterilmediği alanları içeren bir çağrıyı onaylayamaz. bu, Part 2'de çizilen iş mantığı ile agent arasındaki sınırı güvenli hale getiriyor.

Microservislerde ya da agent-business ayrımında çalışıyorsan, bu yaklaşım kontrat-first mimarisinin gücünü gösteriyor. Kod üretimi, insan hatalarını otomatik olarak yakalar.