Bằng lái xe#
Cung cấp phương thức để trích xuất thông tin trên ảnh chụp của cả 2 mặt của Bằng lái xe Việt Nam cả hai phiên bản cũ và mới.
API ở mục này sẻ trả về những thông tin dữ liệu trích xuất được từ ảnh chụp Giấy phép lái xe. với mỗi trường hệ thống cũng trích xuất độ tự tin (confidence) theo % tương ứng để làm cơ sở tham chiếu độ tin cậy của hệ thống. Các thông tin được trích xuất bao gồm:
Trường thông tin |
Mô tả |
|---|---|
id |
Số GPLX |
id_type |
Mặt GPLX |
document |
Loại GPLX |
name |
Họ tên |
birthday |
Ngày tháng năm sinh |
class_type |
Loại bằng (mặt trước) |
back_side_info |
Thông tin mặt sau |
address |
Địa chỉ |
nationality |
Quốc tịch |
issue_place |
Nơi cấp |
issue_date |
Ngày cấp (mặt trước) |
expiry |
Ngày hết hạn |
seri_id |
Số seri |
Trường back_side_info bao gồm:
Trường thông tin |
Mô tả |
|---|---|
class_name |
Tên hạng bằng |
class_date |
Ngày cấp |
class_conf |
Độ tự tin |
Quy ước giá trị của một số trường thông tin:
Trường thông tin |
Quy ước giá trị |
|---|---|
id_type |
0: Mặt trước 1: Mặt sau |
Các trường hợp trả về.
Result code |
Message |
Note |
|---|---|---|
200 |
Success |
Trích xuất thông tin thành công |
101 |
Document not found |
Không tìm thấy GPLX trong hình |
103 |
ID not found |
Khong tìm thấy số GPLX |
105 |
Name not found |
Không tìm thấy tên |
Request
Gọi vào API POST /driver-license-reader, kèm theo các thông tin tối thiểu sau:
- content: Nội dung của file dưới dạng base64.
Ví dụ
CLI:
cURL:
curl -X 'POST' \
'https://api-uat.unicloud.ai/ekyc/driver-license-reader' \
-u $MY_AUTH \
-H 'Content-Type: application/json' \
-d '{
"content": "IMAGE_BASE64",
"name": "gplx.jpg"
}'
Jo:
jo -d. content=%gplx.jpg name=gplx.jpg | http -a $MY_AUTH https://api-uat.unicloud.ai/ekyc/driver-license-reader
Response
Trường hợp thành công:
Mặt trước
{
"id": "0fc9a517-4c72-22ef-a1b6-5d345d9abcfe",
"linked_file_ids": [
"de8be2f2-122b-4c2d-9c02-f245213bf29bc"
],
"recognized_data": {
"address": "P. An Hải Bắc, Q. Sơn Trà, TP. Đà Nẵng",
"addressconf": "[0.9]",
"birthday": "02/11/2002",
"birthdayconf": "[0.9]",
"class_type": "A1",
"class_type_conf": "[0.9]",
"document": "GPLX NEW",
"expiry": "Không thời hạn",
"id": "515318014912",
"id_type": "0",
"idconf": "[0.9]",
"issue_date": "22/10/2019",
"issue_date_conf": "[0.9]",
"issue_place": "Bình Dương",
"issue_place_conf": "[0.91]",
"name": "NGUYỄN VÁN A",
"nameconf": "[0.9]",
"nationality": "VIỆT NAM",
"server_tag": "sst-v1.26.1-cpu",
"reliability": "[0.0, -1.0]"
},
"result_code": 200,
"message": "Success"
}
Mặt sau
{
"id": "31d32e05-2b32-42sa-a08a-1w7c5ebfba63",
"linked_file_ids": [
"e111b95a-ed05-4d1f-ae48-ds34942a415e"
],
"recognized_data": {
"back_side_info": [
{
"class_name": "A2",
"class_date": "13/05/2014",
"class_conf": "0.98"
},
{
"class_name": "A3",
"class_date": "22/01/2009",
"class_conf": "0.94"
},
{
"class_name": "A4",
"class_date": "06/05/2011",
"class_conf": "1.0"
},
{
"class_name": "E",
"class_date": "07/01/2005",
"class_conf": "1.0"
},
{
"class_name": "FC",
"class_date": "24/06/2010",
"class_conf": "0.95"
}
],
"document": "GPLX NEW",
"id_type": "1",
"seri_id": "AD999999",
"seri_id_conf": "[0.6]",
"server_tag": "sst-v1.26.1-cpu",
"reliability": "[0.0, -1.0]"
},
"result_code": 200,
"message": "Success"
}