Распознавание скана паспорта

P.0065.PAS.SCN

Распознавание паспортов граждан Российской Федерации.

Распознаётся первый разворот (вторая и третья страницы) паспорта. По каждому полю в ответе выдаётся распознанное значение и точность в процентах. Точность распознавания зависит от качества изображения и составляет 95 % для рукописных полей и 99 % для машинопечатных при высоком качестве изображения.

Требования к фото: максимальный размер — 15 Мбайт, разрешение — не ниже 512×512 пикселей. Максимальное время загрузки фото — 3 с.

Идентификаторы объекта: ссылка на фото или скан документа.

Иcпользуемые источники: check_person/recognition_doc_by_type_passport.

Время генерации отчёта:

  • 50-й перцентиль — 2 с;
  • 95-й перцентиль — 4 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
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"
          }
        }
      }
    }
  ]
}