Zum Hauptinhalt springen
Der Symphony API Contract Vector (SACV) verwaltet versionierte API-Verträge über die gesamte Plattform. Seine Engine ist ein unabhängig installierbarer C++-Prozess, der begrenzte OpenAPI-3.2.0-JSON-Validierung, deterministische Kompatibilitäts-Diffs und verwerfbare Inventare durchführt. Die Semantik von Endpunkten verbleibt beim domänenverantwortlichen Vektor oder Modul; SACV regelt Vertragsform und Kompatibilität.

Operationen

  • Inspect und Check: validieren, dass ein OpenAPI-3.2.0-JSON-Dokument dem begrenzten Profil entspricht.
  • Diff: deterministische Kompatibilitäts-Diffs zwischen Vertragsversionen berechnen.
  • Propose: vom Aufrufer deklarierte Registry-Vorschläge für neue oder geänderte Verträge entgegennehmen.
  • Project: verwerfbare Inventare für Prüfer und nachgelagerte Werkzeuge ausgeben.

Was SACV regelt

SACV begrenzt:
  • die Vertragsform (OpenAPI 3.2.0 mit dem SACV-Profil)
  • die Kompatibilitätsklassifizierung zwischen Versionen
  • die Registry-Zugehörigkeit akzeptierter Verträge
Er tut Folgendes nicht:
  • Endpunktsemantik verantworten (diese behält jeder Vektor bzw. jedes Modul)
  • SDKs generieren, Artefakte veröffentlichen oder Tokens ausstellen
  • implizieren, dass eine Live-Netzwerkoberfläche existiert (die Erwähnung einer künftigen privaten API erzeugt keine)
SACV beschränkt sich auf Lesen, Abfragen, Validieren und Vorschlagen. Programmatisches kanonisches Apply ist für alle SKV-Engines deaktiviert.

Verwandte Oberflächen

SKV-Übersicht

Das übergreifende Framework und das Contract-Quad-Modell.

SODV

Regelt jede offizielle Veröffentlichung eines bei SACV registrierten Vertrags.

SAV

Bewertet Komposition und Kompatibilität über deklarierte Komponenten hinweg.

qxctl-Vektorbefehle

Führen Sie qxctl sacv ... aus, um zu untersuchen, zu prüfen, zu vergleichen und vorzuschlagen.
Zuletzt geändert am 10. Oktober 2026