Распознавание ПТС

parseAuto/multiple/pts

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

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

Параметры:

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

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

Фотография должна соответствовать требованиям к качеству

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

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

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

POST /idx/api2/parseAuto/multiple/pts 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="pts.jpg"
Content-Type: image/jpeg

[File data]
------

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

{
    "resultCode": 0,
    "resultMessage": "",
    "operationToken": "6933bb2410b74a91bd1cfe8536af4a33",
    "items": [*поле типа документа и объекты полей ПТС*]
}

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

{
    "resultCode": -25,
    "resultMessage": "Источник не доступен. Рекомендуем повторить запрос через 5 минут."
}

Поле типа документа и объектов полей ПТС

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

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

Пример объекта "Поля считанные с ПТС" в формате json:

{
    "docType": "digital_vehicle_passport_page_1",
    "fields": [*Поля считанные с ПТС*]
}

Поля считанные с ПТС

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

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

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

Атрибут	Тип	Описание
address	Field	Адрес собственника
cabine	Field	Кузов, кабина
category	Field	Категория ТС
chassis	Field	Шасси (рама)
color	Field	Цвет кузова
country	Field	Страна вывоза ТС
issueDate	Field	Дата выдачи паспорта
docNumber	Field	Номер ПТС
docSeries	Field	Серия ПТС
emptyMass	Field	Масса без нагрузки
engineNumber	Field	Модель, № двигателя
enginePower	Field	Мощность двигателя
engineType	Field	Тип двигателя
engineVolume	Field	Рабочий объем двигателя
issuer	Field	Наименование организации, выдавшей паспорт
maxMass	Field	Разрешенная макс. масса
model	Field	Марка, модель ТС
specialMarks	Field	Особые отметки
type	Field	Наименование (тип ТС)
vehicleOwner	Field	Наименование ФИО собственника (фронтальная сторона)
vin	Field	VIN
year	Field	Год изготовления ТС
date	Field	Дата продажи (передачи)
name	Field	Наименование ФИО собственника (задняя сторона)

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

{
    "cabine": {
        "text": "ОТСУТСТВУЕТ",
        "confidence": 0.9645066261291504
    },
    "chassis": {
        "text": "JT23400W904345460",
        "confidence": 0.9416484832763672
    },
    "docNumber": {
        "text": "164303000003450",
        "confidence": 0.9753708839416504
    },
    "enginePower": {
        "text": "269,9",
        "confidence": 0.9101460456848145
    },
    "maxMass": {
        "text": "3300",
        "confidence": 0.9869457006454468
    },
    "model": {
        "text": "LEXUS",
        "confidence": 0.9980340003967285
    },
    "vehicleCategory": {
        "text": "B",
        "confidence": 0.9884860001946285
    },
    "vehicleType": null,
    "vin": {
        "text": "JT23400W904345460",
        "confidence": 0.9759120941162109
    },
    "year": {
        "text": "2010",
        "confidence": 0.9933214783668518
    }
}