Ana içeriğe atla
Symphony API Contract Vector (SACV), platform genelinde sürümlenmiş API sözleşmelerini yönetir. Engine’i; sınırlı OpenAPI 3.2.0 JSON doğrulaması, deterministik uyumluluk farkları ve atılabilir envanterler üreten, bağımsız olarak kurulabilen bir C++ sürecidir. Uç nokta anlamları, alanın sahibi olan vektörde veya modülde kalır; SACV sözleşme biçimini ve uyumluluğu yönetir.

İşlemler

  • İnceleme ve kontrol: Bir OpenAPI 3.2.0 JSON belgesinin sınırlı profile uygun olduğunu doğrular.
  • Fark (diff): Sözleşme sürümleri arasında deterministik uyumluluk farklarını hesaplar.
  • Önerme: Yeni veya değiştirilmiş sözleşmeler için çağıran tarafından bildirilen kayıt defteri önerilerini kabul eder.
  • Projeksiyon: İnceleyiciler ve sonraki araçlar için atılabilir envanterler üretir.

SACV neyi yönetir

SACV şunları sınırlar:
  • Sözleşme biçimi (SACV profiliyle OpenAPI 3.2.0)
  • Sürümler arasındaki uyumluluk sınıflandırması
  • Kabul edilen sözleşmeler için kayıt defteri üyeliği
Şunları yapmaz:
  • Uç nokta anlamlarına sahip olmak (bunlar her vektörde veya modülde kalır)
  • SDK üretmek, yapıt yayımlamak veya belirteç (token) vermek
  • Canlı bir ağ yüzeyinin var olduğunu ima etmek (gelecekteki özel bir API’den bahsedilmesi onu oluşturmaz)
SACV yalnızca okuma, sorgulama, doğrulama ve önerme yapar. Programatik kanonik uygulama, SKV engine’lerinin tamamında devre dışıdır.

İlgili yüzeyler

SKV'ye genel bakış

Çatı çerçeve ve Contract Quad modeli.

SODV

SACV’ye kayıtlı bir sözleşmenin her türlü resmî yayınını yönetir.

SAV

Bildirilen bileşenler arasındaki kompozisyonu ve uyumluluğu değerlendirir.

qxctl vektör komutları

İnceleme, kontrol, fark ve önerme için qxctl sacv ... komutunu çalıştırın.
Son değiştirilme tarihi 10 Ekim 2026