Б.10 Сервис подтверждения операций по регистрации УЗ через интеграционный модуль ЕПГУ
Для регистрации учетной записи необходимо выполнить отправку запроса метода POST: https://esia.gosuslugi.ru/esia-rs/api/public/v2/prns/import/REST_API/0 (для продуктивной среды).
Входные параметры запроса описаны в приложении Б.9 Импорт учетной записи пользователя.
Пример запроса (вызов сервиса в среде разработки):
POST https://esia.gosuslugi.ru/esia-rs/api/public/v2/prns/import/REST_API/0 HTTP/1.1
Accept-Encoding: gzip,deflate
Content-Type: application/json
Authorization: Bearer
eyJ2ZXIiOjEsInR5cCI6IkpXVCIsInNidCI6ImFjY2VzcyIsImFsZyI6IkdPU1QzNDEwIn0.eyJzY29wZSI6Imh0dHA
6XC9cL2VzaWEuZ29zdXNsdWdpLnJ1XC9leHRfaW1wIiwiaXNzIjoiaHR0cDpcL1wvZXNpYS5nb3N1c2x1Z2kucnVcLy
IsInVybjplc2lhOnNpZCI6IjQwYjBmNzhhLWY0ZmItNDhiYS1iNjFhLTI3M2NmOTNiZDdmYiIsInVybjplc2lhOnNia
l9pZCI6MTAwMDAwMDAwMiwiZXhwIjoxNTU5OTgzNzUyLCJpYXQiOjE1NTk4OTczNTIsImNsaWVudF9pZCI6IlRFU1Rf
U1lTIn0.V4RffDdsEEQDhBaZ4VJ-tT9dmdWgC5qOU-ZxlVtf0dSQsSBILwOFpQI18s-
nMStgDGlnnUSR4sgtX4RMW5TITQ
Cache-Control: no-cache
Content-Length: 1476
Host: esia-portal1.test.gosulsugi.ru
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)
{
"snils": "000-000-000 01",
"contacts": {
"elements": [
{
"type": "MBT",
"value": "+7(900)0000000"
}
]
},
"firstName": "Иванов",
"lastName": "Иван",
"middleName": "Иванович",
"gender": "M",
"trusted": "true",
"birthDate": "01.01.1990",
"birthPlace": "Воронеж",
"citizenship": "RUS",
"documents": {
"elements": [
{
"issueDate": "18.03.2016",
"issueId": "725453",
"issuedBy": "РУВД г.Москвы",
"number": "111111",
"series": "1000",
"type": "RF_PASSPORT"
}
]
}
}
В запрос должен быть добавлен header (Authorization: Bearer) с ранее полученным маркером доступа, выданный на специальный scope (http://esia.gosuslugi.ru/ext_imp), позволяющий осуществлять автоматический импорт учетной записи пользователя. Данный маркер выдается только доверенным системам, имеющим право импорта пользователей таким образом; выдача маркера осуществляется в рамках модели контроля доступа на основе полномочий системы-клиента, т.е. право на запрос такого маркера доступа устанавливается оператором эксплуатации ЕСИА.
Также запрос должен быть подписан электронной подписью системы, которая импортирует учетную запись в ЕСИА (Request-Data-Sign), и содержать тело запроса, закодированное в формате URL-Safe Base64 (Request-Data).
По персональным данным, указанным в запросе, выполняется поиск Учетной записи в ЕСИА. В зависимости от того, найдена в ЕСИА учетная запись, удовлетворяющая полученным данным, или нет, операция импорта может завершиться одним из следующих результатов:
Пример ответа на запрос (пользователь уже зарегистрирован в ЕСИА, учетная запись уже подтверждена ранее):
X-Powered-By: Servlet/3.0 JSP/2.2
{"code":"0", "description":"Person already has trusted account in ESIA"}
Пример ответа на запрос (запрос на регистрацию успешно отправлен, создана заявка на регистрацию):
X-Powered-By: Servlet/3.0 JSP/2.2
{
"requestId": "AAAA1D6E3E9F965664CB2F7F7C2CDEE19DCD83922B5E71CFB8B3",
"code": "2",
"description": "Request to register person as trusted in ESIA has been accepted
successfully."
}
В ответе передаются следующие параметры:
|
requestId |
Код заявки на регистрацию |
Возвращается в случае создания заявки на регистрацию. |
|
|
code |
Код завершения операции |
Может быть возвращен в виде значений: - 0 или 1 - выполнена регистрация учетной записи; - 2 - создана заявка на регистрацию учетной записи; - код ошибки, варианты приведены в Таблице 12. |
|
|
description |
Текстовое описание кода завершения операции |
Описание для кодов успешного импорта учетной записи в ЕСИА (code = 0, 1 или 2) и для code = ESIA-03200 |
|
|
message |
Текстовое описание кода ошибки выполнения операции |
Варианты ошибок приведены в Таблице 12 |
В случае создания заявки на регистрацию, пользователю на номер мобильного телефона, указанного в запросе, будет отправлен СМС-код подтверждения. Полученный код необходимо отправить в ЕСИА. Для этого требуется выполнить отправку запроса метода POST: https://esia.gosuslugi.ru/esia-rs/api/public/v2/confirmation/compare (для продуктивной среды).
В запросе на подтверждение кода (из СМС) передаются следующие данные:
|
requestId |
Код заявки на регистрацию |
Возвращается в случае создания заявки на регистрацию. |
|
|
Code |
Код подтверждения, отправленный пользователю на номер мобильного телефона. |
Направляется пользователю, в случае создания заявки на регистрацию. |
Пример запроса (вызов сервиса в среде разработки):
По полученным данным в ЕСИА выполняется проверка кода подтверждения. В ответе передаются следующие параметры:
|
requestId |
Код заявки на регистрацию |
|
|
createdTime |
Время создания запроса |
|
|
mobile |
Номер мобильного |
|
|
status |
Статус выполнения операции |
|
|
confirmationWay |
Признака подтверждения |
|
|
availableAttemptsCount |
Оставшееся количество попыток ввода кода подтверждения. |
|
|
maxInputAttemptsCount |
Максимальное количество ввода подтверждения. |
|
|
periodsForNextGeneration |
Интервал времени между переотправкой СМС. |
|
|
resendCount |
Количество попыток по переотправке СМС с кодом подтверждения. |
|
|
timeToLive |
Срок жизни кода подтверждения. |
Пример ответа в случае если код подтверждения указан правильно:
"requestId":"AAAA0EF8369F965664CB48D753590B7269A3CF453DD0554E4DBA",
"createdTime":1557766520905,
"mobile":"79000000000",
"status":"OK",
"confirmationWay":"REST_API",
"availableAttemptsCount":5,
"maxInputAttemptsCount":5,
"periodsForNextGeneration":[
60000,
60000,
60000
],
"resendCount":1,
"timeToLive":86400000
}
В таблице ниже перечислены возможные статусы (поле: status) выполнения операции:
|
OK |
Код подтверждения указан верно |
|
|
WAIT |
Код подтверждения указан не верно |
|
|
NOT_FOUND |
Информация о данном коде подтверждения не найдена |
|
|
TOO_FAST_RESEND |
Невозможно выполнить переотправку СМС с кодом подтверждением. С момента отправки последнего СМС прошло слишком мало времени (Параметр: periodsForNextGeneration) |
|
|
RESEND_LIMIT_IS_REACHED |
Повторная переотправка СМС невозможна (Параметр: resendCount) |
|
|
EXPIRED |
Истек срок жизни кода подтверждения (Параметр: timeToLive) |
Для возможности переотправки кода подтверждения пользователю, требуется выполнить отправку запроса метода POST: https://esia.gosuslugi.ru/esia-rs/api/public/v2/confirmation/resend/requestId (для продуктивной среды). В запросе необходимо указывать код заявки на регистрацию (Параметр: requestId).
- Гражданский кодекс (ГК РФ)
- Жилищный кодекс (ЖК РФ)
- Налоговый кодекс (НК РФ)
- Трудовой кодекс (ТК РФ)
- Уголовный кодекс (УК РФ)
- Бюджетный кодекс (БК РФ)
- Арбитражный процессуальный кодекс
- Конституция РФ
- Земельный кодекс (ЗК РФ)
- Лесной кодекс (ЛК РФ)
- Семейный кодекс (СК РФ)
- Уголовно-исполнительный кодекс
- Уголовно-процессуальный кодекс
- Производственный календарь на 2023 год
- МРОТ 2024
- ФЗ «О банкротстве»
- О защите прав потребителей (ЗОЗПП)
- Об исполнительном производстве
- О персональных данных
- О налогах на имущество физических лиц
- О средствах массовой информации
- Производственный календарь на 2024 год
- Федеральный закон "О полиции" N 3-ФЗ
- Расходы организации ПБУ 10/99
- Минимальный размер оплаты труда (МРОТ)
- Календарь бухгалтера на 2024 год
- Частичная мобилизация: обзор новостей