Siirry pääsisältöön
Symphony API Contract Vector (SACV) hallinnoi versioituja API-sopimuksia koko alustalla. Sen moottori on itsenäisesti asennettava C++-prosessi, joka suorittaa rajatun OpenAPI 3.2.0 JSON -validoinnin, deterministiset yhteensopivuuserot ja kertakäyttöiset inventaariot. Päätepisteiden semantiikka pysyy toimialan omistavalla vektorilla tai moduulilla; SACV hallinnoi sopimusten muotoa ja yhteensopivuutta.

Operaatiot

  • Tarkastelu ja tarkistus: validoi, että OpenAPI 3.2.0 JSON -dokumentti noudattaa rajattua profiilia.
  • Erot: laske deterministiset yhteensopivuuserot sopimusversioiden välillä.
  • Ehdotus: ota vastaan kutsujan ilmoittamia rekisteriehdotuksia uusille tai muuttuneille sopimuksille.
  • Projektio: tuota kertakäyttöisiä inventaarioita tarkastajille ja jatkotyökaluille.

Mitä SACV hallinnoi

SACV rajaa:
  • Sopimuksen muodon (OpenAPI 3.2.0 SACV-profiililla)
  • Versioiden välisen yhteensopivuusluokittelun
  • Hyväksyttyjen sopimusten rekisterijäsenyyden
Se ei:
  • Omista päätepisteiden semantiikkaa (kukin vektori tai moduuli pitää ne)
  • Luo SDK:ita, julkaise artefakteja tai myönnä tunnisteita
  • Merkitse, että elävä verkkopinta olisi olemassa (tulevan yksityisen API:n mainitseminen ei luo sellaista)
SACV on vain luku-, kysely-, validointi- ja ehdotusmoottori. Ohjelmallinen kanoninen soveltaminen on poissa käytöstä kaikissa SKV-moottoreissa.

Liittyvät pinnat

SKV-yleiskatsaus

Kattokehys ja Contract Quad -malli.

SODV

Hallinnoi SACV:hen rekisteröidyn sopimuksen virallista julkaisua.

SAV

Arvioi koostamista ja yhteensopivuutta ilmoitettujen komponenttien välillä.

qxctl-vektorikomennot

Suorita qxctl sacv ... tarkastellaksesi, tarkistaaksesi, verrataksesi ja ehdottaaksesi.
Viimeksi muokattu 10. lokakuuta 2026