Salt la conținutul principal
Symphony API Contract Vector (SACV) guvernează contractele API versionate în întreaga platformă. Motorul său este un proces C++ instalabil independent, care efectuează validări JSON OpenAPI 3.2.0 delimitate, diferențe de compatibilitate deterministe și inventare de unică folosință. Semantica endpoint-urilor rămâne la vectorul sau modulul care deține domeniul; SACV guvernează forma și compatibilitatea contractelor.

Operații

  • Inspectare și verificare: validează că un document JSON OpenAPI 3.2.0 respectă profilul delimitat.
  • Diff: calculează diferențe de compatibilitate deterministe între versiunile contractelor.
  • Propunere: acceptă propuneri de registru declarate de apelant pentru contracte noi sau modificate.
  • Proiecție: emite inventare de unică folosință pentru revizori și instrumentele din aval.

Ce guvernează SACV

SACV delimitează:
  • Forma contractului (OpenAPI 3.2.0 cu profilul SACV)
  • Clasificarea compatibilității între versiuni
  • Apartenența la registru pentru contractele acceptate
Nu:
  • Deține semantica endpoint-urilor (fiecare vector sau modul o păstrează)
  • Generează SDK-uri, publică artefacte sau emite tokenuri
  • Implică existența unei suprafețe de rețea active (menționarea unui viitor API privat nu creează unul)
SACV este doar de citire, interogare, validare și propunere. Aplicarea canonică programatică este dezactivată în toate motoarele SKV.

Suprafețe asociate

Prezentare generală SKV

Cadrul-umbrelă și modelul Contract Quad.

SODV

Guvernează orice publicare oficială a unui contract înregistrat în SACV.

SAV

Evaluează compoziția și compatibilitatea între componentele declarate.

Comenzi vectoriale qxctl

Rulați qxctl sacv ... pentru a inspecta, verifica, compara și propune.
Ultima modificare pe 10 octombrie 2026