OpenAPI 3.1
Đặc tả tham chiếu và điểm cuối mẫu.
KIOWARE NHÀ PHÁT TRIỂN CENTER
Tài liệu tham chiếu API KioWare
Danh mục điểm cuối, resource, sự kiện, lỗi, idempotency, tracing và quản lý phiên bản cho KioWare.
NHÀ PHÁT TRIỂN ASSETS
Tài sản kỹ thuật
Postman
Biến môi trường, xác thực và request mẫu.
Events
Schema, thử lại, deduplication và tương quan.
Acceptance
UAT checklist và bằng chứng nghiệm thu.
BẢO MẬT BASELINE
Quy tắc vận hành chính thức
- Không nhúng secret trong ứng dụng Kiosk
- Mọi lệnh thay đổi trạng thái có idempotency key
- Mọi giao dịch có truy vết/mã tương quan
- Sự kiện consumer phải xử lý duplicate và out-of-order
- Production credential chỉ cấp sau security review
CAPABILITY CATALOG
Danh mục API theo miền năng lực
Đặc tả dưới đây là cấu trúc tham chiếu để khám phá và PoC; điểm cuối vận hành chính thức chỉ được cấp sau khi thống nhất phiên bản, quyền và phạm vi dữ liệu.
Phiên API
Khởi tạo, gia hạn, kết thúc và phục hồi phiên có mã tương quan.
v1 · JSON · trace-idThiết bị Năng lực API
Đọc năng lực, sức khỏe, version và trạng thái ngoại vi.
v1 · JSON · trace-idChính sách API
Nhận chính sách đã ký, áp dụng version và báo cáo kết quả thực thi.
v1 · JSON · trace-idTelemetry API
Gửi metric, nhật ký và sự kiện theo lược đồ dữ liệu có version.
v1 · JSON · trace-idBằng chứng API
Truy vấn bằng chứng, kiểm toán reference và trạng thái đối soát.
v1 · JSON · trace-idControl Plane API
Quản trị thiết bị, nhóm, cấu hình và rollout theo quyền.
v1 · JSON · trace-idDELIVERY GOVERNANCE
Vòng đời cấp quyền API
- 01Design review
- 02Môi trường thử nghiệm đặc tả
- 03Bảo mật review
- 04UAT bằng chứng
- 05Production credential
- 06Version and deprecation governance