Распознавание паспортов граждан Российской Федерации.
Распознаётся первый разворот (вторая и третья страницы) паспорта. По каждому полю в ответе выдаётся распознанное значение и точность в процентах. Точность распознавания зависит от качества изображения и составляет 95 % для рукописных полей и 99 % для машинопечатных при высоком качестве изображения.
Требования к фото: максимальный размер — 15 Мбайт, разрешение — не ниже 512×512 пикселей. Максимальное время загрузки фото — 3 с.
Идентификаторы объекта: ссылка на фото или скан документа.
Иcпользуемые источники: check_person/recognition_doc_by_type_passport
.
Время генерации отчёта:
При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:
Параметр | Тип | Обязательность | Описание |
---|---|---|---|
queryType |
string | Обязательный | Тип запроса. Фиксированное значение: MULTIPART |
query |
string | Обязательный | Значение простого запроса. Фиксированное значение: |
data |
object | Обязательный | Идентификаторы объекта поиска |
Параметры объекта data |
|||
image_url |
string | Обязательный | URL изображения |
document_type |
string | Обязательный | Тип документа. Фиксированное значение: PASSPORT_MAIN — Паспорт гражданина РФ 1й разворот |
{
"queryType": "MULTIPART",
"query": " ",
"data": {
"image_url": "https://some.domain/image_1.png",
"document_type": "PASSPORT_MAIN"
}
}
Данные отчёта находятся в объекте data[].content.check_person.recognition_doc_by_type
тела ответа.
Поле | Тип | Описание |
---|---|---|
status |
string | Статус распознавания документа. Справочник значений |
status_desc |
string | Описание статуса распознавания документа |
validation_errors |
object | Ошибки валидации |
document_type |
string | Тип документа. Справочник значений |
passport_main.surname |
object | Фамилия |
passport_main.first_name |
object | Имя |
passport_main.other_names |
object | Отчество |
passport_main.date_of_birth |
object | Дата рождения |
passport_main.place_of_birth |
object | Место рождения |
passport_main.series_and_number |
object | Серия и номер паспорта |
passport_main.issuing_authority |
object | Паспорт выдан |
passport_main.date_of_issue |
object | Дата выдачи |
passport_main.subdivision_code |
object | Код подразделения |
Поле | Тип | Описание |
---|---|---|
text |
string | Значение поля |
confidence |
number | Точность распознавания поля |
Значение | Описание |
---|---|
OK | Документ успешно распознан |
DOCUMENT_TYPE_IS_NOT_ALLOWED | Данный тип документа не входит в число разрешенных |
LOW_IMAGE_QUALITY | Низкое качество фото |
DOCUMENT_TYPE_NOT_MATCH | Загруженное фото не соответствует выбранному типу документа |
VALIDATION_FAIL | Ошибка валидации |
PAYLOAD_TOO_LARGE | Файл слишком большой |
DOWNLOAD_FAIL | Ошибка при загрузке файла |
CLASSIFY_FAIL | Ошибка при классификации |
RECOGNITION_FAIL | Ошибка при распознавании |
NONE | Ошибка |
Значение | Описание |
---|---|
passport_main | Паспорт гражданина РФ 1й разворот |
none | Не установлен |
{
"data": [
{
"report_type_uid": "P.0065.PAS.SCN_test_report@test_domain",
"progress_ok": 1,
"progress_wait": 0,
"progress_error": 0,
"state": {
"sources": [
{
"_id": "check_person/recognition_doc_by_type_passport",
"state": "OK",
"data": {}
}
],
"data": {}
},
"content": {
"check_person": {
"recognition_doc_by_type": {
"status": "OK",
"status_desc": "Документ успешно распознан",
"document_type": "passport_main",
"passport_main": {
"surname": {
"text": "ПЕТРОВА",
"confidence": 0.990304708480835
},
"first_name": {
"text": "АЛЕКСАНДРА",
"confidence": 0.9975243210792542
},
"other_names": {
"text": "ПЕТРОВНА",
"confidence": 0.9935157299041748
},
"date_of_birth": {
"text": "21.03.1977",
"confidence": 0.5895552039146423
},
"place_of_birth": {
"text": "ГОР. ЮЖНО-САХАЛИНСК",
"confidence": 0.9462395906448364
},
"series_and_number": {
"text": "1234 123456",
"confidence": 0.8923658132553101
},
"issuing_authority": {
"text": "ОТДЕЛОМ УФМС РОССИИ ПО КАЛИНИНСКОЙ ОБЛ. В ОКТЯБРЬСКОМ Р-НЕ Г. КЛИН",
"confidence": 0.9803095459938049
},
"date_of_issue": {
"text": "01.01.2016",
"confidence": 0.6371174454689026
},
"subdivision_code": {
"text": "770-000",
"confidence": 0.9900240898132324
}
}
}
}
}
}
]
}
{
"data": [
{
"report_type_uid": "P.0065.PAS.SCN_test_report@test_domain",
"progress_ok": 1,
"progress_wait": 0,
"progress_error": 0,
"state": {
"sources": [
{
"_id": "check_person/recognition_doc_by_type_passport",
"state": "OK",
"data": {}
}
],
"data": {}
},
"content": {
"check_person": {
"recognition_doc_by_type": {
"status": "DOCUMENT_TYPE_NOT_MATCH",
"status_desc": "Загруженное фото не соответствует типу документа PASSPORT_MAIN",
"document_type": "none"
}
}
}
}
]
}