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ố API tham chiếu cho asset, challenge, proof, activity, screening và report.
MÔ HÌNH TÀI NGUYÊN
| Phương thức | Endpoint | Mục đích |
|---|---|---|
POST | /v1/assets | Register wallet or digital-asset assertion |
POST | /v1/challenges | Create a proof-of-control challenge |
POST | /v1/proofs/verify | Verify an approved signed challenge |
GET | /v1/assets/{assetId}/report | Export the assurance report |
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-AA-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.