NHÀ PHÁT TRIỂN · CHECKID

Mô hình dữ liệu

Giấy tờ định danh, tiến trình, kết quả cuối, chứng chỉ, nội dung và chi tiết giao dịch.

Trao đổi với chuyên gia Tích hợp kỹ thuật

HỢP ĐỒNGAPI / SDK có quản lý phiên bản

XÁC THỰCOAuth2 / môi trường

ĐẦU RAPhản hồi · mã kết quả · bằng chứng

PHỤ LỤC A / ĐỐI TƯỢNG

Bản đồ mô hình dữ liệu

Mỗi đối tượng dưới đây được ánh xạ về đặc tả nguồn; code định danh giữ nguyên English.

Hợp đồng API nguồnPhụ lục A · Mô tả Đối tượng + Mục 7 · Đối tượng

identity_document

Loại · giá trị

Giấy tờ loại include PASSPORT, DRIVER_LICENSE, IDENTITY_CARD, CITIZEN_CARD, FACE_SCAN, FACE_FRAME.

process

process_id · trạng thái · nhà cung cấp · process_type · kết quả

Tài nguyên và trạng thái xác minh.

document_verification

name · expiry · tính nhất quán · giấy tờ · DOB · đơn vị phát hành · kết quả

Giấy tờ xác minh kết quả trường.

facial_similarity

similarity_score · visual_authenticity · face_comparison · image_integrity · kết quả

Khuôn mặt comparison kết quả trường.

final_result

Thuộc tính danh tính · similarity_score · claim_sources

Kết quả xác minh cuối cùng / nguồn tuyên bố đã ký.

certificates

Chứng chỉ · chủ thể · đơn vị phát hành · thumbprint · serial · key_hash · validity

Chứng chỉ metadata đối tượng.

payload

subject_id · process_id · trường quy trình có điều kiện

Thực thi quy trình nội dung.

transaction_details

Type-specific kết quả/bằng chứng

Cấu trúc chi tiết giao dịch thay đổi theo từng loại giao dịch.

THAM CHIẾU KỸ THUẬT

Mô hình dữ liệu: ngữ nghĩa trường phải bám đặc tả

Nguồn → Phạm vi → Triển khai → Bằng chứng → Giới hạn

Chủ thể

Công khai ví dụ cho thấy chủ thể có chủ sở hữu/loại chủ thể, bối cảnh giấy tờ danh tính và contact/trường danh tính tùy thao tác. Không coi mọi trường là mandatory chỉ vì xuất hiện trong tạo ví dụ chủ thể.

Quy trình

Quy trình mang `process_type`, `mục đích`, trạng thái và có điều kiện bằng chứng/kết quả. Một chủ thể có thể có nhiều quy trình; vì vậy quy trình không đồng nghĩa vòng đời chủ thể.

Kết quả

`perform_result` là đối tượng chứa kết quả phụ thuộc loại quy trình; ví dụ PASSIVE_AUTHENTICATION có `passive_authentication_status`. Không generalize một trường của một loại quy trình cho tất cả quy trình.

Quản lý / giao dịch

Giao dịch quản lý view có định danh như billcode/quy trình; quyền truy cập phụ thuộc phân loại. Các trường PII/restricted không được công bố nếu nguồn phân loại không cho phép.

Quy tắc bảng lược đồ

Mỗi trường công khai phải có loại, bắt buộc/tùy chọn/có điều kiện, enum nếu known, nguồn phiên bản và mô tả. Nếu nguồn chưa đủ, trạng thái là nguồn bắt buộc thay vì tự đoán.

Ví dụ

Ví dụ dùng placeholder nhất quán; raw key/enum/lỗi không dịch sang tiếng Việt.