API OCR hộ chiếu Việt Nam

Nhận dạng hộ chiếu Việt Nam như thế nào

Hộ chiếu Việt Nam tuân theo tiêu chuẩn ICAO 9303: một vùng đọc máy gồm hai dòng, mỗi dòng 44 ký tự (định dạng TD3), được in ở cuối trang thông tin, bên dưới vùng kiểm tra thị giác dành cho người đọc. Năm ký tự đầu tiên của nó là P<VNM – mã loại giấy tờ, sau đó là quốc gia cấp theo mã ISO 3166-1 alpha-3 VNM. API đọc cả hai vùng, đối chiếu các chữ số kiểm tra của MRZ, và trả về một cấu trúc phản hồi duy nhất với đầy đủ mọi khóa.

Việt Nam là VN trong danh sách alpha-2 và VNM trong vùng MRZ: ở đây mã dài chính là mã ngắn thêm M ở cuối. Điều đó đúng với cặp mã này chứ không phải là quy tắc, nên suy ra mã này từ mã kia là một lỗi chỉ chờ đến quốc gia đầu tiên không khớp.

Các vùng đọc máy do Việt Nam cấp

9303 định nghĩa ba bố cục vùng đọc máy, và API đọc được cả ba. Bên dưới là một người sở hữu giả định – cô ấy không phải ai cả, và paradeigma là từ tiếng Hy Lạp nghĩa là ví dụ – trong từng bố cục, với VNM là quốc gia cấp. Mọi chữ số kiểm tra đều được tính từ các ký tự bên cạnh chứ không gõ tay, nên mọi vùng ở đây đều hợp lệ.

P<VNMPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184VNM9403084F3203101PN48291630<<<<72

I<VNMPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

IDVNMAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<

Không có chữ số kiểm tra nào bảo vệ quốc gia cấp: trên cả ba bố cục, phép tính chạy trên số giấy tờ, các ngày tháng và dữ liệu tùy chọn, không bao giờ trên ba ký tự cho biết ai đã cấp giấy tờ. Một vùng MRZ có mọi chữ số kiểm tra hợp lệ vẫn chưa chứng minh được nó đến từ Việt Nam – điều đó do vùng thị giác và các đặc điểm bảo an của chính giấy tờ đảm nhận.

Dán một MRZ vào trình phân tích MRZ để kiểm tra các chữ số kiểm tra, hoặc tạo một MRZ bằng trình tạo MRZ.

Các trường bạn nhận lại

Mọi hộ chiếu Việt Nam được nhận dạng đều trả về cùng các trường có cấu trúc. Giá trị không đọc được là null, không bao giờ là một khóa bị thiếu.

• Họ và tên
• Ngày sinh và giới tính
• Số giấy tờ và số định danh cá nhân
• Quốc tịch và quốc gia cấp (VNM)
• Ngày cấp và ngày hết hạn, số ngày còn lại
• Kết luận về MRZ, và các dòng mà nó được đọc ra

Xem mọi trường trong trình tra cứu trường dữ liệu giấy tờ (bằng tiếng Anh).

Thực hiện lệnh gọi

Chạy lệnh này với sandbox công khai – không cần đăng ký, nhận dạng thật, miễn phí cho một số lượng giấy tờ giới hạn và 10 yêu cầu mỗi giờ cho mỗi IP. Thay khóa sandbox bằng khóa live của riêng bạn để tiếp tục nhận dạng hộ chiếu Việt Nam.

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"

Tài liệu liên quan

Trang này trình bày những gì riêng cho Việt Nam. Bốn trang bên dưới (bằng tiếng Anh) chứa mọi thứ còn lại.

• Nhận dạng hộ chiếu

  Lệnh gọi ở trên với một giấy tờ thật, bằng curl, JavaScript và Python, cùng giải thích từng khóa trong câu trả lời.

• MRZ và vùng thị giác

  Vì sao một giấy tờ in cùng thông tin hai lần, nên tin vùng nào khi chúng không khớp, và các chữ số kiểm tra nói trên chứng minh được gì và không chứng minh được gì.

• Ngôn ngữ và hệ chữ của các trường

  Vùng MRZ là bản chuyển tự Latinh; vùng thị giác thì không. Kết quả đọc nào mang hệ chữ gốc, và một mã định danh ngôn ngữ được quy về ngôn ngữ như thế nào.

• Lỗi

  Mọi mã lỗi mà API có thể trả về, trong một bảng: nguyên nhân, gọi lại có thể thành công hay không, và lệnh gọi có bị tính phí hay không.