Перейти к содержанию

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

Пример использования опции "Улучшенное качество" для рукописных Паспортов РФ и регистраций через API:

Примеры изображений документов

Документы для обработки должны быть закодированы в формат base64

Пример ответа по обработанному документу:

{
  "document_id": "s-44529",
  "documents": [
    {
      "key": "PASSPORT",
      "type": "PASSPORT",
      "data": {
        "LastName": "",
        "FirstName": "",
        "MiddleName": "",
        "Gender": "",
        "BirthDate": "",
        "BirthPlace": "",
        "Series": "",
        "Number": "",
        "IssuedBy": "",
        "IssueDate": "",
        "IssueId": "",
        "Address": "",
        "HasPhoto": "",
        "HasOwnerSignature": "",
        "MRZ1": "",
        "MRZ2": ""
      },
      "metadata": {
        "confidences": {
          "BirthDate": 0.8149347305297852,
          "BirthPlace": 0.21398670971393585,
          "FirstName": 0.4928287863731384,
          "Gender": 0.755740225315094,
          "IssueDate": 0.9399173855781555,
          "IssuedBy": 0.24618881940841675,
          "IssueId": 0.9072410464286804,
          "LastName": 0.24597330391407013,
          "MiddleName": 0.4213537573814392,
          "Number": 0.9999756813049316,
          "Series": 0.9999756813049316
        },
        "verifications": {
          "status": 0,
          "status_text": "ok",
          "checks": {
            "verify_passport": [
              {
                "status": 0,
                "key": "fields_to_check_valid",
                "title": "Одно или несколько обязательных полей отсутствует, имеет неверный формат, имеет неверную контрольную сумму МЧЗ"
              },
              {
                "status": "",
                "key": "fio_series_number_mrz",
                "title": "МЧЗ не согласуется со значением полей"
              },
              {
                "status": 0,
                "key": "series_okato",
                "title": "Серия паспорта не согласуется с кодом подразделения"
              },
              {
                "status": 0,
                "key": "region_valid",
                "title": "Место выдачи не согласуется с кодом подразделения"
              },
              {
                "status": 0,
                "key": "issued_after_14",
                "title": "Паспорт выдан до 14-ти лет"
              },
              {
                "status": 0,
                "key": "issued_after_1997",
                "title": "Паспорт выдан до 1 октября 1997 года"
              },
              {
                "status": 0,
                "key": "expiration_date",
                "title": "Паспорт просрочен"
              }
            ]
          },
          "bad_fields": [
            "Series",
            "MiddleName",
            "Number",
            "MRZ2",
            "FirstName",
            "LastName",
            "MRZ1"
          ]
        },
        "metadata_check": {
          "status": 0,
          "checks": {
            "source_check": 1,
            "suspicious_app_detection": 0,
            "suspicious_value": "",
            "create_date": "",
            "make": "",
            "model": ""
          }
        },
        "external_integrations": {
          "terrorist_extremist": {
            "value": false
          }
        }
      },
      "broken": null,
      "broken_reasons": [],
      "broken_reasons_ru": []
    }
  ]
}

Описание ключей

Ключ Тип Описание
document_id string номер документа в формате s-<номер документа>
documents list список данных по каждому документу
documents[].key string ключ заданный при отправке документа для отслеживания
documents[].type string тип документа
documents[].data dictionary обработанные данные по каждому полю,
содержит ключи полей и их определенные значения
IssuedBy string кем выдан паспорт
IssueDate string дата выдачи паспорта
IssueId string код подразделения
Series string серия паспорта с первого разворота
Number string номер паспорта с первого разворота
Gender string пол
LastName string фамилия
FirstName string имя
MiddleName string отчество
BirthDate string дата рождения
BirthPlace string место рождения
HasPhoto boolean или string попала ли в кадр фотография владельца
HasOwnerSignature boolean или string попала ли в кадр подпись владельца
MRZ1 string первая строка машиночитаемой записи
MRZ2 string вторая строка машиночитаемой записи
metadata dictionary содержит ключи метаданных
confidences dictionary
{key: float}
метаданные с точностью обработки по каждому полю -
содержит ключи полей и значения уровня уверенности.
Значения от 0.0000 до 0.9999, где чем значение больше,
тем уверенность в результате выше.
Максимальная уверенность - 0.9999.
verifications dictionary
{key: boolean, key: integer}
метаданные совершенных проверок -
содержит ключи и их значения проверок,
см. Правила проверок