Автоматическое распознавание основных полей Таджикских паспортов

parseAuto/multiple/passportTajikistan

Данный вызов недоступен в личном кабинете

Для подключения обратитесь на support@iidx.ru

Тип HTTP запроса: multipart POST

URL вызова: https://api.id-x.org/idx/api2/parseAuto/multiple/passportTajikistan

Параметры:

Параметр	Тип	Обязательный	Описание
accessKey	String	Да	Ключ доступа, выданный при регистрации в Системе IDX
secretKey	String	Да	Секретный ключ, выданный при регистрации в Системе IDX
file	File	Да	Фотография документа

Проверка распознает следующие форматы: JPG, JPEG, PNG, BMP, TIFF

Фотография должна соответствовать требованиям к качеству На фото/скане должен находиться один основной разворот документа (там где основная информация о персоне) Если документ представляет собой id карту - то должна быть либо одна сторона, либо обе

Функция возвращает:

Параметр	Тип	Обязательный	Описание
resultCode	Int	Да	Результат выполнения функции (0 – успешное завершение функции, -27 – некорректное изображение, иные значения – ошибка выполнения)
resultMessage	String	Нет	Сообщение об ошибке
operationToken	String	Нет	Уникальный идентификатор операции
items	Массив типа Item	Нет	Массив объектов – поле типа документа и объектов полей документа Подробнее см. поле типа документа и объектов полей Таджикского загранпаспорта

Пример вызова:

POST /idx/api2/parseAuto/multiple/passportTajikistan HTTP/1.1
Host: api.id-x.org
Content-Type: multipart/form-data; boundary=----
Accept: application/json

------
Content-Disposition: form-data; name="accessKey"

Выданный accessKey
------
Content-Disposition: form-data; name="secretKey"

Выданный secretKey
------
Content-Disposition: form-data; name="file"; filename="file.jpg"
Content-Type: image/jpeg

[File data]
------

Пример успешного ответа:

{
    "resultCode": 0,
    "resultMessage": "",
    "operationToken": "faea0efca87d4972b9778977c0ec261c",
    "items": [*поле типа документа и объекты полей Таджикского загранпаспорта*]
}

Пример неуспешного ответа:

{
    "resultCode": -27,
    "resultMessage": "Некорректное изображение."
}

Поле типа документа и объектов полей Таджикского загранпаспорта

Тип объекта Item:

Параметр	Тип	Описание
docType	String	Тип документа
fields	Массив типа Field	Массив объектов – поля считанные с Таджикского загранпаспорта Подробнее см. поля считанные с Таджикского загранпаспорта

Пример объекта "Поля считанные с Таджикского загранпаспорта" в формате json:

{
    "docType": "...",
    "fields": [*Поля считанные с загранпаспорта*]
}

Поля считанные с загранпаспорта

Тип объекта Field:

Параметр	Тип	Описание
text	String	Значение атрибута
confidence	Double	Индекс корректности распознавания

Это объект, содержащий следующие атрибуты:

Атрибут	Тип	Описание
authorityEng	Field	Орган который выдал
mrzType	Field	Тип mrz
issuingStateCode	Field	Код региона/страны
personalNumber	Field	Персональный номер
fullNameEng	Field	ФИ на английском
lastNameEng	Field	Фамилия на английском
issuingStateNameEng	Field	Имя региона/страны
expiryDate	Field	Дата окончания действия
nameEng	Field	Имя на английском
number	Field	Номер документа или серия + номер
nationalityCode	Field	Код национальности
mrz	Field	Строка mrz
nameTajikCyrillic	Field	Имя на таджикском кириллицей
sexTajikCyrillic	Field	Пол на таджикском кириллицей
lastNameTajikCyrillic	Field	Фамилия на таджикском кириллицей
nationalityTajikCyrillic	Field	Национальность на таджикском кириллицей
documentClassCode	Field	Код типа документа
nationalityEng	Field	Национальность на английском
fullNameTajikCyrillic	Field	Полное имя на таджикском кириллицей
issueDate	Field	Дата выдачи
sexEng	Field	Пол на английском
birthDate	Field	Дата рождения
midNameTajikCyrillic	Field	Отчество на таджикском кириллицей
authorityTajikCyrillic	Field	Орган который выдал на таджикском кириллицей

Пример Item, некоторые поля могут не возвращаться в зависимости от документа:

{
        "docType": "some text",
        "fields": {
            "authorityEng": {
                "text": "some text",
                "confidence": 0.9
            },
            "mrzType": {
                "text": "some text",
                "confidence": 0.78
            },
            "issuingStateCode": {
                "text": "some text",
                "confidence": 1.0
            },
            "nationalityTajikCyrillic": {
                "text": "some text",
                "confidence": 1.0
            },
            "fullNameTajikCyrillic": {
                "text": "some text",
                "confidence": 0.83
            },
            "lastNameTajikCyrillic": {
                "text": "some text",
                "confidence": 1.0
            },
            "sexTajikCyrillic": {
                "text": "some text",
                "confidence": 1.0
            },
            "personalNumber": {
                "text": "some text",
                "confidence": 0.74
            },
            "fullNameEng": {
                "text": "some text",
                "confidence": 0.67
            },
            "lastNameEng": {
                "text": "some text",
                "confidence": 1.0
            },
            "birthDate": {
                "text": "some text",
                "confidence": 1.0
            },
            "expiryDate": {
                "text": "some text",
                "confidence": 1.0
            },
            "issuingStateNameEng": {
                "text": "some text",
                "confidence": 0.78
            },
            "nameEng": {
                "text": "some text",
                "confidence": 1.0
            },
            "number": {
                "text": "some text",
                "confidence": 1.0
            },
            "nationalityCode": {
                "text": "some text",
                "confidence": 0.85
            },
            "mrz": {
                "text": "some text",
                "confidence": 0.68
            },
            "nameTajikCyrillic": {
                "text": "some text",
                "confidence": 1.0
            },
            "documentClassCode": {
                "text": "some text",
                "confidence": 1.0
            },
            "nationalityEng": {
                "text": "some text",
                "confidence": 1.0
            },
            "authorityTajikCyrillic": {
                "text": "some text",
                "confidence": 0.95
            },
            "issueDate": {
                "text": "some text",
                "confidence": 1.0
            },
            "sexEng": {
                "text": "some text",
                "confidence": 1.0
            }
        }
    }