NHÀ PHÁT TRIỂN · CheckID · API 1.2.260123

Nhóm định danh sinh trắc học

Quản lý nhóm cho định danh 1:N bằng khuôn mặt, vân tay và mống mắt.

Trao đổi với chuyên gia Bắt đầu tích hợp

Nguồn hợp đồng APIĐặc tả API và Kafka CheckIDV1.2.260123

1:N SINH TRẮC HỌC ĐỊNH DANH

Vòng đời nhóm định danh

Tách rõ 1:N định danh khỏi 1:1 xác minh.

01Khởi tạoKhuôn mặt · Vân tay · Mống mắt

02Bổ sungThêm định danh

03Tạo quy trìnhx-group-id bắt buộc

04Thực thiKhuôn mặt · Vân tay · Mống mắt

05Đối sánhTrả về chủ thể

06Gỡ bỏ / XóaQuản lý vòng đời

FACE

FACIAL_IDENTIFICATION

Nhận dạng khuôn mặt 1:N.

FINGERPRINT

FINGERPRINT_IDENTIFICATION

Nhận dạng vân tay 1:N.

IRIS

IRIS_IDENTIFICATION

Nhận dạng mống mắt 1:N.

THAM CHIẾU API

Đặc tả thực tế: Khởi tạo nhóm định danh

POST · /identification/v1/initialize/group

Điểm kết nối & mục đích

POST /identification/v1/initialize/group. Khởi tạo chủ thể cho nhận dạng 1:N khuôn mặt, vân tay hoặc mống mắt.

Xác thực

Bearer . Không thay đổi cơ chế này bằng suy đoán từ tài liệu kế thừa.

Phạm vi công bố

Đối tác. Nguồn: CheckID API đặc tả V1.2.260123 §2.2.2.

Cấu trúc yêu cầu

{
  "process_type": "FACIAL_IDENTIFICATION",
  "identity_documents": [
    {
      "type": "CITIZEN_CARD",
      "value": "<DOCUMENT_NUMBER>"
    }
  ]
}

Cấu trúc phản hồi

{
  "x-group-id": "FACIAL_IDENTIFICATION_<GROUP_ID>",
  "status": 201
}

Lỗi / khôi phục

Ngữ nghĩa lỗi phải dùng raw đặc tả/danh mục lỗi; cơ chế thử lại/tính bất biến khi lặp/thời gian chờ chỉ được áp dụng nếu nguồn tương ứng định nghĩa.