Chuyển đến nội dung chính
Symphony API Contract Vector (SACV) quản trị các hợp đồng API có phiên bản trên toàn nền tảng. Engine của nó là một tiến trình C++ có thể cài đặt độc lập, thực hiện xác thực JSON OpenAPI 3.2.0 có giới hạn, so sánh tương thích tất định và kiểm kê dùng một lần. Ngữ nghĩa endpoint vẫn thuộc về vector hoặc module sở hữu miền; SACV quản trị hình dạng hợp đồng và tính tương thích.

Thao tác

  • Inspect và check: xác thực rằng một tài liệu JSON OpenAPI 3.2.0 tuân thủ hồ sơ có giới hạn.
  • Diff: tính toán so sánh tương thích tất định giữa các phiên bản hợp đồng.
  • Propose: tiếp nhận đề xuất registry do bên gọi khai báo cho hợp đồng mới hoặc đã thay đổi.
  • Project: xuất kiểm kê dùng một lần cho người xem xét và các công cụ hạ nguồn.

Những gì SACV quản trị

SACV giới hạn:
  • Hình dạng hợp đồng (OpenAPI 3.2.0 với hồ sơ SACV)
  • Phân loại tương thích giữa các phiên bản
  • Tư cách thành viên registry cho các hợp đồng được chấp nhận
Nó không:
  • Sở hữu ngữ nghĩa endpoint (mỗi vector hoặc module tự giữ phần đó)
  • Tạo SDK, xuất bản tạo phẩm hay cấp token
  • Ngụ ý rằng có một bề mặt mạng đang hoạt động (việc nhắc đến một API riêng tư trong tương lai không tạo ra nó)
SACV chỉ đọc, truy vấn, xác thực và đề xuất. Apply chuẩn tắc theo chương trình bị vô hiệu hóa trên tất cả SKV engine.

Các bề mặt liên quan

Tổng quan SKV

Khung bao trùm và mô hình Contract Quad.

SODV

Quản trị mọi lần xuất bản chính thức của một hợp đồng đã đăng ký với SACV.

SAV

Đánh giá thành phần và tính tương thích giữa các thành phần đã khai báo.

Lệnh vector của qxctl

Chạy qxctl sacv ... để inspect, check, diff và propose.
Lần sửa đổi cuối 10 tháng 10, 2026