Skip to content

Ускоренная комплексная проверка паспорта РФ

checkPassportFast

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

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

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

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

Поддерживаются следующие форматы передачи параметров:

  • JSON, Content-Type: application/json

  • Form submit, Content-Type: application/x-www-form-urlencoded

Параметры:

Параметр Тип Обязательный Описание
accessKey String Да Ключ доступа, выданный при регистрации в Системе IDX
secretKey String Да Секретный ключ, выданный при регистрации в Системе IDX
lastName String Да Фамилия
firstName String Да Имя
midName String Нет Отчество (при наличии)
birthDate String Нет Дата рождения в формате ДД.ММ.ГГГГ
passportNumber String Да Номер паспорта, серия и номер слитно без разделителей
passportDate String Нет Дата выдачи паспорта, в формате ДД.ММ.ГГГГ
isConsentAccepted Boolean Да Признак согласия клиента на обработку его персональных данных (true – согласие дано, обязательное значение для обработки данных, false – согласие не дано)
isConsentResponsibility Boolean Да Признак осведомленности об ответственности за нарушение правил сбора согласия (true – осведомлены, обязательное значение для обработки данных, false – не осведомлены)
dateConsentGiven String Да Дата получения согласия, в формате ДД.ММ.ГГГГ

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

Параметр Тип Обязательный Описание
resultCode Int Да Результат выполнения функции (0 – успешное завершение функции, отличное от 0 значение – ошибка выполнения)
resultMessage String Нет Сообщение об ошибке
operationToken String Нет Уникальный идентификатор операции
score Int Нет Числовой результат проверки. Варианты результатов см. расшифровка скоринга
description String Нет Текстовое описание результата проверки
scoreDetails String Нет Дополнительный код расшифровки результата. Варианты результатов см. расшифровка деталей скоринга
descriptionDetails String Нет Текстовое описание дополнительного кода результата

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

POST /idx/api2/checkPassportFast
Host: api.id-x.org
Content-Type: application/json
Accept: application/json

{
    "accessKey": "выданный accessKey",
    "secretKey": "выданный secretKey",
    "lastName": "Иванов",
    "firstName": "Иван",
    "midName": "Иванович",
    "birthDate": "01.01.1970",
    "passportNumber": "1234567890",
    "passportDate": "01.01.2010",
    "isConsentAccepted": true,
    "isConsentResponsibility": true,
    "dateConsentGiven": "01.01.2020"
}

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

{
    "resultCode": 0,
    "resultMessage": "",
    "operationToken": "82e9d6ec643242e348bbefbe4d7b",
    "score": 100,
    "description": "Паспорт действителен"
}

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

{
    "resultCode": 0,
    "resultMessage": "",
    "operationToken": "82e9d6ec643242e348bbefbe4d7b",
    "score": 50,
    "description": "Данные верифицированы не полностью",
    "scoreDetails": "NAME_PASSPORT_OK",
    "descriptionDetails": "Верифицирована связка ФИО-Паспорт, дата рождения не передавалась, дата выдачи не верифицирована"
}

Пример ответа, если паспорт недействителен:

{
    "resultCode": 0,
    "resultMessage": "",
    "operationToken": "82e9d6ec643242e348bbefbe4d7b",
    "score": -10,
    "description": "Паспорт недействителен"
}

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

{
    "resultCode": 0,
    "resultMessage": "",
    "operationToken": "82e9d6ec643242e348bbefbe4d7b",
    "score": 0,
    "description": "Данные не найдены"
}

Расшифровка скоринга

Значение Описание
100 Паспорт действителен
50 Данные верифицированы не полностью
0 Данные не найдены
-10 Паспорт недействителен

Расшифровка деталей скоринга

Значение Описание
NAME_OK Верифицированы ФИО. Дата рождения, паспорт и дата выдачи не верифицированы
NAME_BIRTHDATE_OK Верифицирована связка ФИО-ДР. Паспорт и дата выдачи не верифицированы
NAME_PASSPORT_OK Верифицирована связка ФИ-Паспорт. Дата рождения и дата выдачи не верифицированы
NAME_PASSPORT_DATE_OK Верифицирована связка ФИО-Паспорт-Дата выдачи. Дата рождения не верифицирована
NAME_BIRTHDATE_PASSPORT_OK Верифицирована связка ФИО-ДР-Паспорт. Дата выдачи не верифицирована