HEADER DÙNG CHUNG
Authorization: Bearer <token> X-Correlation-Id: <uuid> Idempotency-Key: <uuid> X-Request-Timestamp: <RFC3339> Content-Type: application/json
HỢP ĐỒNG API THAM CHIẾU
Đã công bố hợp đồng API tham chiếu theo ETSI QKD 014 và key lease.
MÔ HÌNH TÀI NGUYÊN
| Phương thức | Endpoint | Mục đích |
|---|---|---|
GET | /v1/key-pools | Read pool health and site status |
POST | /v1/keys/lease | Lease a policy-approved key identifier |
POST | /v1/keys/{keyId}/consume | Record one-time key consumption |
POST | /v1/failover | Switch to approved alternate site or fallback policy |
HEADER DÙNG CHUNG
Authorization: Bearer <token> X-Correlation-Id: <uuid> Idempotency-Key: <uuid> X-Request-Timestamp: <RFC3339> Content-Type: application/json
ENVELOPE REQUEST
{
"profileId": "QS-QB-2026.07",
"requestId": "5fda47cb-55c8-45a8-81a6-2dd1d1938b47",
"mode": "controlled-evaluation",
"evidenceRequired": true
}MÔ HÌNH LỖI
400 — Schema không hợp lệ hoặc profile chưa hỗ trợ401/403 — Từ chối authentication hoặc policy409 — Xung đột idempotency hoặc trạng thái422 — Chưa đáp ứng yêu cầu evidence hoặc compatibility503 — Dependency bảo vệ không sẵn sàng; fail-closed trừ khi được duyệt khácQUẢN LÝ PHIÊN BẢN
LỘ TRÌNH TRIỂN KHAI
Xác minh API contract cùng test corpus và readiness passport.