Поиск учетной записи в ЕСИА
| Атрибут | Значение |
|---|---|
| Название | esia-search |
| Тип | Адаптер для взаимодействия с ЕСИА через СМЭВ3 |
| Наименование | Поиск учетной записи в ЕСИА |
| Область применения | Межведомственное взаимодействие |
| Версия | 1.4.0 |
| Версия МР | 3.0 |
| Версия СМЭВ | СМЭВ3 |
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | ключ, используемый для подключения к rabbitmq |
| MQ_HOST | хост rabbitmq |
| MQ_PORT | порт rabbitmq |
| SMEV_SERVICE | название смэв сервиса, на который будут отправляться запросы |
| ROUTING_CODE | код маршрутизации на ЕСИА среду |
| RA_ID | идентификатор центра обслуживания |
Переменные для конфигурирования подключения к БД:
DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.
Справочник кодов ЕСИА сред
| Код | Среда |
|---|---|
| DEV | Тестовая среда |
| UAT | Тестовая среда |
| TESIA | Интеграционная тестовая среда (должна использоваться при тестировании получения сведений ИС потребителя) |
| TCOD | Тестовая среда |
| PROD | Продуктивная среда |
Принимаемые параметры
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| routing_code | код маршрутизации на ЕСИА среду | - возьмется из переменной окружения ROUTING_CODE |
DEV |
| snils_operator | СНИЛС оператора центра обслуживания | + | 135-419-238 52 |
| ra | идентификатор центра обслуживаня | - возьмется из переменной окружения RA_ID |
1000321282 |
| lastname | Фамилия | + | Иванов |
| firstname | Имя | + | Иван |
| middlename | Отчество | - обязательно, если отчество присутствует в документе, удостоверяющем личность |
Иванович |
| Адрес электронной почты пользователя | - | test@mail.com | |
| mobile | Номер мобильного телефона пользователя | - | +7(920)4021351 |
| snils | СНИЛС пользователя | - | 987-654-321 95 |
| doc | Документ, удостоверяющий личность пользователя | + | составной тип |
Необходимо, чтобы был заполнен хотя бы 1 из необязательных элементов запроса: email, mobile, snils. Для наиболее эффективного поиска учётной записи рекомендуется указывать максимально возможное количество входных параметров.
Структура элемента doc
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| type | Тип документа, удостоверяющего личность | + | RF_PASSPORT |
| series | Серия документа | + | 0489 Строка. Для паспорта РФ имеет формат XXXX, для заграничного паспорта гражданина РФ имеет формат XX, для документа иностранного гражданина – не более 32 символов |
| number | Номер документа | + | 123456 Строка. Для паспорта РФ имеет формат ХХХХХХ, для заграничного паспорта гражданина РФ имеет формат XXXXXXX, для документа иностранного гражданина – не более 32 символов |
Типы документов, удостоверящих личность
| Код | Описание документа |
|---|---|
| RF_PASSPORT | Паспорт гражданина РФ |
| FID_DOC | Документ иностранного гражданина |
| FRGN_PASS | Заграничный паспорт гражданина РФ |
Параметры ответа
Сервис возвращает последовательность элементов о состоянии регистрации образцов, указанных в запросе.
accounts - список найденных учетных записей
errors - список ошибок
Структура элемента account
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| oid | Идентификатор учетной записи | + | 1000349826 |
| stu | Статус учетной записи | + | trusted |
| stu_description | Описание статуса учетной записи | + | Подтвержденная |
| regDate | Дата регистрации учетной записи | + | 2017-11-14 |
| cfmTyp | Тип подтверждения учетной записи | - | RA |
| cfmTyp_description | Описание типа подтверждения | - | Центр обслуживания |
| biomStu | Наличие биометрической информации (Y/N) | + | N |
| matches | Перечень параметров, по которым была найдена учетная запись | + | ["snils", "mobile","idoc"] |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"routing_code": "DEV",
"snils_operator": "123-456-789 10",
"ra": "42",
"lastname": "Иванов",
"firstname": "Иван",
"middlename": "Иванович",
"doc": {
"type": "RF_PASSPORT",
"series": "0404",
"number": "776947"
},
"email": "test@mail.com",
"mobile": "+7(999)0001117",
"snils": "987-654-321 10"
}
В случае корректной настройки должен прийти следующий ответ:
{
"accounts": [
{
"oid": "1000349826",
"stu": "trusted",
"matches": [
"snils",
"mobile",
"idoc"
],
"regDate": "14.11.2017",
"cfmTyp": "RA",
"biomStu": "N",
"stu_description": "Подтвержденная",
"cfmTyp_description": "Центр обслуживания"
}
]
}