Trung tâm tích hợp
Mô hình bằng chứng
Dành cho nhà cung cấp, đội phát triển và đối tác tích hợp. Mỗi API liên kết với dịch vụ, ngữ cảnh và bằng chứng.
GET /evidence/{id}
Tra cứu sự kiện trong phạm vi được phép, không trả mẫu sinh trắc học.
Lược đồ yêu cầu minh họa
| Trường | Kiểu | Yêu cầu |
|---|---|---|
requestId | chuỗi | Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học. |
tenantRef | chuỗi | Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học. |
purpose | chuỗi | Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học. |
deviceRef | chuỗi | Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học. |
evidenceId | chuỗi | Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học. |
Mô phỏng & mã mẫu
Mô phỏng cục bộ - không gọi mạngv0.4.0 (dự thảo)
Chưa có địa chỉ Sandbox/UAT thật được phê duyệt. Không nhập dữ liệu cá nhân hay sinh trắc học.
Yêu cầu
Phản hồi minh họa
200{
"requestId": "demo-request-001",
"traceId": "demo-trace-001",
"service": "evidence",
"modelStatus": "ILLUSTRATIVE_ONLY",
"evidenceId": "demo-evidence-001",
"subjectRef": "demo-patient-001",
"purpose": "patient-verification",
"deviceRef": "demo-device-001",
"policyRef": "demo-policy-001",
"eventTime": "2026-09-09T00:00:00Z",
"timeSource": "SERVER_CLOCK_ILLUSTRATIVE",
"integrityStatus": "NOT_EVALUATED",
"evidenceRef": "demo-evidence-001"
}Mã gọi HTTP - không phải SDK
Máy chủ example.invalid không phải điểm kết nối vận hành chính thức. Mã mẫu yêu cầu cấu hình xác thực và mTLS đã được phê duyệt.
Ngoại lệ và thử lại
| HTTP | Mã mẫu | Hành vi khuyến nghị |
|---|---|---|
| 422 | CAPTURE_QUALITY_LOW | Thu nhận chưa đạt; hướng dẫn thử lại. |
| 422 | PRESENTATION_REJECTED | Không tiếp tục phiên; chuyển phương án thay thế theo chính sách. |
| 409 | SESSION_EXPIRED | Tạo phiên mới, không phát lại dữ liệu cũ. |
| 403 | DEVICE_UNTRUSTED | Từ chối phiên và chuyển đội vận hành kiểm tra thiết bị. |
| 403 | SCOPE_NOT_ALLOWED | Kiểm tra quyền ứng dụng khách, tổ chức và mục đích. |
| 429 | RATE_LIMITED | Tôn trọng Retry-After, giới hạn số lần thử lại. |
| 503 | PROCESSING_UNAVAILABLE | Không suy diễn thành công; dùng phương án thay thế. |