Спецификация API ЕПГУ (версия 1.11)
Спецификация
API ЕПГУ
версия 1.11
2023 г.
API ЕПГУ
Оглавление
Термины и определения
3
1. Требования к получению маркера доступа
4
2. Получение справочных данных
5
3. Подача заявления
7
3.1. Описание процесса подачи заявления
7
3.2. Реализация подключения по ГОСТ TLS
10
3.3. Создание заявления
11
3.4. Загрузка архива
12
3.5. Загрузка архива по частям
14
4. Отмена заявления
16
5. Получение деталей по заявлению
17
6. Скачивание файла
24
7. Получение статусов заявлений
25
7.1. Получение статусов всех заявлений с даты обновления статуса
25
7.2. Получение статусов заявлений по переданному списку заявлений
26
8. Примеры запросов и ответов
28
8.1. Создание заявления
28
8.2. Получение справочных данных
28
8.3. Загрузка архива
29
8.4. Загрузка архива по частям
30
8.5. Отмена заявления
31
8.6. Получение деталей по заявлению
31
8.7. Получение статусов заявлений
33
История изменений документа
36
2
API ЕПГУ
Термины и определения
Термин
Описание
ВИС
Внешняя информационная система
ВС
Вид сведений
ГОСТ TLS
Защищённое соединение по протоколу безопасности
транспортного уровня TLS (transport layer security), с
использованием российских криптоалгоритмов,
соответствующих межгосударственным стандартам (ГОСТ)
ЕПГУ
Федеральная государственная информационная система
«Единый портал государственных и муниципальных услуг
(функций)» (http://www.gosuslugi.ru/).
ЕСИА
Федеральная государственная информационная система
«Единая система идентификации и аутентификации в
инфраструктуре, обеспечивающей информационно-
технологическое взаимодействие информационных систем,
используемых для предоставления государственных и
муниципальных услуг в электронной форме»
ИС
Информационная система
ЛК
Личный кабинет пользователя ЕПГУ
ЕЛК
Единый личный кабинет госуслуг предоставляет сервис для
синхронизации информации о заявлениях на получение
госуслуг и стадии их исполнения между внешними
информационными системами и Единым порталом Госуслуг.
Сервис доступен федеральным, региональным, муниципальным
органам власти и МФЦ.
Скоуп
Область доступа
ФРГУ
Федеральный реестр государственных услуг
ЭП
Электронная подпись
КЭП
Квалифицированная электронная подпись
ФСТЭК России
Федеральная служба по техническому и экспортному контролю
ФГИС
Федеральная государственная информационная система
3
API ЕПГУ
Настоящий документ (далее
- Спецификация) является дополнением
к документам (далее - Связанные документы), необходимым для подключения по
прикладному программному интерфейсу (далее
- API) Единого портала
государственных и муниципальных услуг (функций) (далее - ЕПГУ), расположенных
по ссылке https://partners.gosuslugi.ru/catalog/api_for_gu, а именно:
Регламент подключения к API Госуслуг (далее - Регламент);
Руководство пользователя для организации-вендора по формированию
API-Key и получению маркера доступа (далее - Руководство вендора);
Руководство
пользователя
для
организации-потребителя
по
формированию API-Key и получению маркера доступа (далее
-
Руководство потребителя);
Заполнение данных для конкретной услуги описано в спецификации
соответствующей услуге/сервису.
1. Требования к получению маркера доступа
Требования к получению маркера доступа зависят от типа получателя услуги.
Для получателей физических лиц маркер доступа получается в соответствии с разделом
«Приложение В. Сервисы ЕСИА, основанные на протоколе OAuth2.0 и OpenID Connect
1.0» (подпункт В.2) методических рекомендаций по использованию ЕСИА (документ
выложен на странице https://partners.gosuslugi.ru/catalog/esia).
Для получателей юридических лиц и индивидуальных предпринимателей
требования к получению маркера доступа зафиксированы в разделе «Приложение Б.
Сервисы ЕСИА на базе подхода REST» пункте «Б.12 Сервис получения маркера
доступа по идентификационному ключу» методических рекомендаций по
использованию
ЕСИА
(документ
выложен
на
странице
Формирование и получение идентификационного ключа API-Key
осуществляется в соответствии с регламентами, размещенными на странице
«Руководство пользователя для организации-вендора по формированию
API-Key и получение маркера доступа»;
«Руководство
пользователя
для
организации-потребителя
по
формированию API-Key и получение маркера доступа».
ВИС необходимо реализовать механизм получения маркера доступа к
следующим скоупам ЕПГУ:
4
API ЕПГУ
Таблица 1
Скоуп
Назначение скоупа
Подача заявлений с использованием
программного интерфейса портала госуслуг
Предоставление доступа к скоупу осуществляется в соответствии с документом
«Регламент информационного взаимодействия Участников с Оператором ЕСИА и
Оператором эксплуатации инфраструктуры электронного правительства» (документ
выложен на странице https://partners.gosuslugi.ru/catalog/esia). Наименование скоупа
необходимо указывать в поле «Получение данных из регистров ЕСИА через
программные интерфейсы OAuth 2.0 / REST-API» заявки.
При получении маркера доступа можно указывать несколько скоупов. В случае
получения маркера доступа на сотрудника организации в нём обязательно должен
присутствовать один из скоупов ЕСИА для получения данных этой организации.
Например,
получение
ОГРН
организации,
где <value>
- внутренний
идентификатор организации в ЕСИА (обязательный параметр).
2. Получение справочных данных
В соответствии со спецификациями услуг, доступных в REST API ЕПГУ, для
формирования заявления на получение услуги (файл в формате XML) могут
потребоваться справочные сведения, хранящиеся в ЕСНСИ и/или ЕПГУ и доступные
для получения по выделенному REST-сервису.
Информация о том, какие сведения из каких справочников (справочные
значения и наименования справочников) необходимы в заявлении определены в
спецификации конкретной услуги.
Для получения справочных данных необходимо вызвать следующий метод:
Таблица 2
Среда ЕПГУ
URL
Тестовая среда
SVCDEV
Продуктивная среда
Метод запроса: POST
Метод доступен без авторизации.
5
API ЕПГУ
{code} - код справочника.
В заголовке запросе необходимо передавать Content-Type = application/json.
В теле запроса должен передаваться JSON объект со следующими параметрами:
Таблица 3
Параметр
Описание
Тип,
Обязательно
значения
сть
treeFiltering
Тип справочника (плоский /
ONELEVEL /
Да
иерархический)
SUBTREE
parentRefItemValue
Код родительского элемента
Строка
Нет
pageNum
Номер необходимой страницы
Число
Нет
pageSize
Количество записей на
Число
Нет
странице
В случае отсутствия в запросе параметров pageNum и pageSize возвращаются все
элементы справочника.
В случае положительного ответа (http-код = 200) в теле возвращается JSON
объект со следующими параметрами:
Таблица 4
Параметр
Описание
Тип
Обязательно
сть
error
Результат
Объект
Да
code
Код результата
Число
Да
message
Сообщение
Строка
Да
fieldErrors
Ошибки в полях запроса
Массив
Нет
объектов
total
Общее количество найденных
Число
Да, в случае
элементов
error. code = 0
items
Найденные элементы с учётом
Массив
Нет
заданных pageNum и pageSize
объектов
value
Код элемента справочника
Строка
Да
parentValue
Код родительского элемента
Строка
Нет
title
Наименование элемента
Строка
Да
isLeaf
Признак наличия подчинённых
Логический
Нет
элементов
children
Подчинённые элементы
Массив
Нет
объектов
attributes
Дополнительные атрибуты
Массив
Нет
элемента справочника
объектов
attributeValue
Список значений
Объект
Нет
s
дополнительных атрибутов
элемента справочника
6
API ЕПГУ
3. Подача заявления
3.1. Описание процесса подачи заявления
Процесс подачи заявления по услугам с подписанием идентичен процессу
подачи заявления по услугам без подписания.
Процесс предполагает два возможных варианта:
1. Если в соответствии со спецификацией услуги предполагается
предварительное указание номера заявления в xml-файле, а также, если
размер загружаемого zip архива более 5 Мб, то отправка разбивается на
этапы:
a. Создание заявления через вызов метода /order;
b. Отправка заявления и загрузка архива с файлами по заявлению
через вызов метода /push/chunked.
2. Если в соответствии со спецификацией услуги не предусмотрено
внесение данных о номере заявления ЕПГУ и размер загружаемого zip
архива менее 5Мб, то отправка происходит в один этап:
a. Отправка заявления и загрузка архива с файлами по заявлению
через вызов метода /push.
Архив должен содержать все необходимые файлы, согласно виду сведений по
услуге. Если услуга предполагает подписание файлов заявления КЭП, то файлы с
отсоединенной подписью так же надо добавить в архив. Спецификациями к
конкретным услугам могут быть установлены и иные ограничения к загружаемым
файлам.
7
API ЕПГУ
sd положительный сценарий
ВИС
ЕПГУ
ЕСИА
alt тип пользователя
[ФЛ]
запрос на авторизацию()
авторизационный код()
запрос на получение маркера доступа(авторизационный код)
макер доступа()
[ЮЛ/ИП]
запрос на получение маркера доступа(идентификационный ключ (api-key))
макер доступа()
alt способ подачи заявления
[С предварительным получением номера заявления или с файлом более 5Мб]
создание заявления()
проверка доступов()
opt
проверка
полномочий()
[Если заявитель ЮЛ и роль не руководитель]
проверка
ограничений()
номер заявления()
формирование xml заявления с
номером заявления()
alt какой чанк файла отправлен
[не последний]
loop загрузка архива
[пока не отправлен последний чанк]
отправка заявления методом push/chunked()
206 Partial Content
(номер заявления)
[последний]
200 Ok(номер заявления)
[Иные]
отправка заявления методом /push()
200 Ok(номер заявления)
opt
получение сведений о заявлении
(номер заявления)
детальная информация о заявлении()
opt
отмена заявления(номер заявления)
200 Ok()
Рисунок 1. Общая схема подачи заявления
8
API ЕПГУ
Рисунок 2. Схема работы с заявлениями
Для работы с заявлением доступны следующие методы:
Таблица 5
Метод
Назначение
POST /api/gusmev/order
Создание заявления
(используется в случае, если нам
нужно вносить номер заявления
в XML запроса или если размер
zip-архива более 5 Мб)
POST /api/gusmev/push
Загрузка архива с файлами
заявления (для случая, если нам
не требуется вносить номер
заявления ЕПГУ в XML запроса
и размер zip архива не более
5Мб)
POST /api/gusmev/push/chunked
Загрузка архива с файлами
9
API ЕПГУ
заявления по частям (для случая,
если нам требуется вносить
номер заявления ЕПГУ в XML
запроса или размер zip архива
более 5Мб)
POST /api/gusmev/order/{orderId}
Получение данных заявления
(информацию по статусам и
другие детали заявления)
POST /api/gusmev/order/{orderId}/cancel
Отмена заявления
GET
Скачать вложение из ответа
/api/gusmev/files/{objectId}/{objectType}/download?m
ведомства
nemonic={mnemonic}
POST
Получение статусов по всем
/api/gusmev/order/getUpdatedAfter/?pageNum={n}&pa
заявлениям с даты обновления
geSize={m}&updatedAfter={timestamp}
статуса
POST
Получение статусов заявлений
/api/gusmev/order/getOrdersStatus/?pageNum={n}&pa
по переданному списку
geSize={m}
заявлений
3.2. Реализация подключения по ГОСТ TLS
В целях реализации возможности установления безопасного соединения по
ГОСТ TLS был создан защищенный контур ЕПГУ, обращения к которому
осуществляется по следующим адресам:
Таблица 6
Среда ЕПГУ
URL
Тестовая среда
SVCDEV
Продуктивная среда
Для обеспечения безопасности данных, обрабатываемых при информационном
взаимодействии с ФГИС ЕПГУ необходимо использовать средство криптографической
защиты информации класса КС1 и выше (в случае, если при взаимодействии не
происходит передача персональных данных от ФГИС ЕПГУ) или КС3 и выше (в
случае, если при взаимодействии происходит передача персональных данных от ФГИС
ЕПГУ), прошедшее сертификацию на соответствие требованиям ФСБ России, а также
10
API ЕПГУ
средство антивирусной защиты, прошедшее сертификацию на соответствие
требованиям к средствам антивирусной защиты, утвержденным приказом ФСТЭК
России от 20 марта 2012 г. № 28 (Профиль защиты ИТ.САВЗ.Г2.ПЗ).
3.3. Создание заявления
Этот метод необходимо использовать только в случае, если по ВС
предусмотрено внесение данных о номере заявления ЕПГУ в XML запроса.
Для создания заявления необходимо вызвать следующий метод:
Таблица 7
Метод
URL
POST
/api/gusmev/order
В заголовке Authorization запроса (тип Bearer) должен передаваться маркер
доступа со скоупом «http://lk.gosuslugi.ru/api-order».
В заголовке запроса необходимо передавать Content-Type = application/json.
В теле запроса должен передаваться JSON объект со следующими параметрами:
Таблица 8
Параметр
Описание
Тип,
Обязательно
значения
сть
ServiceCode
Код интерактивной формы на
Строка
Да
ЕПГУ
TargetCode
Код цели обращения услуги в
Строка
Да
ФРГУ
Region
Код ОКАТО местоположения
Строка
Да
пользователя (можно
передавать код ОКАТО
региона, если невозможно
определить точнее)
В случае положительного ответа (http-код = 200) в теле возвращается JSON
объект с параметрами созданного заявления.
Таблица 9
Параметр
Описание
Тип
orderId
Номер заявления ЕПГУ
Число
В случае ответа с http-код
400 (неверные параметры),
409 (невозможно
обработать запрос) или 500 (внутренняя ошибка) в теле возвращается JSON объект со
следующими параметрами:
Таблица 10
11
API ЕПГУ
Параметр
Описание
Тип
Обязательно
сть
code
Код ошибки
Строка
Нет
message
Текст ошибки
Строка
Нет
В случае ответа с http-код = 401 необходимо получить новый маркер доступа и
повторить запрос.
3.4. Загрузка архива
Этот метод необходимо использовать только в случае, если по ВС не
предусмотрено внесение данных о номере заявления ЕПГУ в XML запроса и размер
загружаемого zip архива менее 5Мб.
Для загрузки архива с файлами по заявлению необходимо вызвать следующий
метод:
Таблица 11
Метод
URL
POST
/api/gusmev/push
В заголовке Authorization запроса (тип Bearer) должен передаваться маркер
доступа со скоупом «http://lk.gosuslugi.ru/api-order». В заголовке Content-Type
необходимо указывать multipart/form-data.
В архив необходимо добавить все файлы заявления, сформированные в
соответствии с правилами, описанными в спецификации услуги, по которой вы подаете
заявление. Файлы необходимо называть в соответствии с требованиями ВС или со
спецификацией по услуге.
В случае подачи заявления с подписанием КЭП, к каждому файлу необходимо
добавить файл с отсоединённой подписью. Наименование файла с отсоединённой
подписью должно совпадать с основным файлом. Например, файл с подписью для
файла req.xml будет req.xml.sig.
В теле запроса должны передаваться параметры:
Таблица 12
Параметр
Описание
Тип,
Обязательно
значения
сть
meta
Метаинформация в формате
Строка
Да
Content-Type = application/json
{"region":"36",
"serviceCode":"10000092161",
12
API ЕПГУ
Параметр
Описание
Тип,
Обязательно
значения
сть
"targetCode":"-1959599598"}
file
Данные загружаемого архива
Двоичные
Да
данные
В случае положительного ответа возвращается http-код
=
200. в теле
возвращается JSON объект со следующими параметрами:
Таблица 13
Параметр
Описание
Тип
Обязательно
сть
orderId
Номер заявления
Число
Да
В случае ответа с http-код
400 (неверные параметры),
409 (невозможно
обработать запрос) или 500 (внутренняя ошибка) в теле возвращается JSON объект со
следующими параметрами:
Таблица 14
Параметр
Описание
Тип
Обязательно
сть
code
Код ошибки
Строка
Нет
message
Текст ошибки
Строка
Нет
В случае ответа с http-код = 401 необходимо получить новый маркер доступа и
повторить запрос.
Список возможных ошибок:
Таблица 15
Текст
Условие
access_denied_system
Доступ запрещен для системы
access_denied_service
Доступ запрещен для сервиса
Доступ запрещен для данного типа
access_denied_user
пользователя
service_not_found
Услуга не найдена
У пользователя нет прав для работы с
order_access
текущим заявлением
13
API ЕПГУ
3.5. Загрузка архива по частям
Этот метод необходимо использовать только в случае, если по ВС
предусмотрено внесение данных о номере заявления ЕПГУ в XML запроса или размер
загружаемого zip архива более 5Мб.
Для загрузки архива с файлами по заявлению необходимо вызвать следующий
метод:
Таблица 16
Метод
URL
POST
/api/gusmev/push/chunked
В заголовке Authorization запроса (тип Bearer) должен передаваться маркер
доступа со скоупом «http://lk.gosuslugi.ru/api-order». В заголовке Content-Type
необходимо указывать multipart/form-data.
В архив необходимо добавить все файлы заявления, сформированные в
соответствии с видом сведений по услуге, по которой вы подаете заявление. Файлы
необходимо называть в соответствии со спецификацией по услуге.
Архив не должен содержать вложенных архивов и папок с передаваемыми
файлами, если это прямо не указано в спецификации услуги.
В случае подачи заявления с подписанием КЭП, к каждому файлу необходимо
добавить файл с отсоединённой подписью. Наименование файла с отсоединённой
подписью должно совпадать с основным файлом. Например, файл с подписью для
файла req.xml будет req.xml.sig.
В теле запроса должны передаваться параметры:
Таблица 17
Параметр
Описание
Тип,
Обязательно
значения
сть
meta
Метаинформация в формате
Строка
Да
Content-Type = application/json
{"region":"36",
"serviceCode":"10000092161",
"targetCode":"-1959599598"}
chunk
Номер чанка
Число
Нет
chunks
Кол-во чанков
Число
Нет
orderId
Номер заявления
Число
Да
file
Данные загружаемого архива
Двоичные
Да
данные
14
API ЕПГУ
Каждый чанк, кроме последнего, не может быть менее 1 Мб и не должен
превышать ограничения в 5 Мб (включительно). Размер последнего чанка может быть
менее 1 Мб.
Чанки можно отправлять в несколько потоков, при этом важна очередность
отправки для первого и последнего чанка. Первым отправляется первый чанк, далее
могут быть отправлены чанки без очередности, последним должен быть отправлен
последний чанк.
Нумерация чанков осуществляется следующим образом:
Chunks = n
Chunk = i (0... n-1)
Все чанки должны быть отправлены в течении 5 минут. Начало отсчета времени
отправки всех чанков начинается с момента отправки первого чанка.
После отправки всех чанков инициируется отправка заявления.
В случае положительного ответа возвращается http-код
=
200. в теле
возвращается JSON объект со следующими параметрами:
Таблица 18
Параметр
Описание
Тип
Обязательно
сть
orderId
Номер заявления
Число
Да
В случае ответа с http-код
400 (неверные параметры),
409 (невозможно
обработать запрос) или 500 (внутренняя ошибка) в теле возвращается JSON объект со
следующими параметрами:
Таблица 19
Параметр
Описание
Тип
Обязательно
сть
code
Код ошибки
Строка
Нет
message
Текст ошибки
Строка
Нет
В случае ответа с http-код = 401 необходимо получить новый маркер доступа и
повторить запрос.
Список возможных ошибок:
Таблица 20
Текст
Условие
access_denied_system
Доступ запрещен для системы
access_denied_service
Доступ запрещен для сервиса
15
API ЕПГУ
Текст
Условие
Доступ запрещен для данного типа
access_denied_user
пользователя
service_not_found
Услуга не найдена
У пользователя нет прав для работы с
order_access
текущим заявлением
4. Отмена заявления
Отмена заявления возможна только после получения от ведомства признака
cancelAllowed со значением true. Данные признак будет указан в ответе метода
получения деталей по заявлению (п.5).
Для отмены заявления требуется вызывать следующий метод:
Таблица 21
Метод
URL
POST
/api/gusmev/order/{orderId}/cancel
В заголовке Authorization запроса (тип Bearer) должен передаваться маркер
доступа со скоупом «http://lk.gosuslugi.ru/api-order».
Таблица 22
Параметр
Описание
Тип,
Обязательно
значения
сть
orderId
Номер заявления
Число
Да
В случае успешного вызова возвращается ответ с http-код = 200.
http-код = 204 информирует, что заявление с указанным номером не найдено.
В случае ответа с http-код = 401 необходимо получить новый маркер доступа и
повторить запрос.
http-код = 403 информирует о том, что у пользователя нет прав для работы с
текущим заявлением.
В случае ответа с http-код = 400 необходимо проверить параметры запроса.
http-код = 409 информирует о невозможности обработать запрос.
Таблица 23
Текст
Условие
У пользователя нет прав для работы с
order_access
текущим заявлением
Отмена заявления в текущем статусе
cancel_not_allowed
невозможна
16
API ЕПГУ
Пример ответа при ошибке:
{
"code": "order_access",
"message": "У пользователя нет прав для работы с текущим заявлением"
}
5. Получение деталей по заявлению
Для получения деталей по заявлению в т.ч. статуса обработки заявления
необходимо вызвать следующий метод:
Таблица 24
Метод
URL
POST
/api/gusmev/order/{orderId}
В заголовке Authorization запроса (тип Bearer) должен передаваться маркер
доступа со скоупом «http://lk.gosuslugi.ru/api-order».
{orderId} - номер заявления.
В случае положительного ответа (http-код = 200) в теле возвращается JSON
объект с параметрами, которые предусмотрены для переданного типа значений:
Таблица 25
Параметр
Описание
Тип
orderType
Тип заявления
Строка
hasNewStatus
Флаг нового статуса для
Логический
заявления
smevTx
Код транзакции СМЭВ3
Строка
stateOrgId
Код ведомства
Числовой
hasEmpowerment2021
Флаг наличия делегирования
Логический
smevMessageId
Идентификатор СМЭВ-
Строка
сообщения от ведомства,
сменившего статус
notifySms
Флаг необходимости
Строка
уведомления о смене статуса
через СМС
notifyEmail
Флаг необходимости
Строка
уведомления о смене статуса
через сообщение на эл. почту
17
API ЕПГУ
notifyPush
Флаг необходимости
Строка
уведомления о смене статуса
через push-сообщение
hasChildren
Флаг наличия дочерних
Логический
заявлений
stateStructureName
Наименование ведомства
Строка
portalCode
Код портала
Строка
formVersion
Версия
Строка
stateOrgStatusCode
Код ведомственного статуса
Строка
stateOrgStatusName
Наименование
Строка
ведомственного статуса
routingCode
Код маршрутизации СМЭВ-
Строка
сообщения в ведомство
orderAttributeEvents
Атрибуты событий для
Массив объектов
заявления (для данных
значений параметра embed
массив будет пустой)
name
Наименование атрибута
Строка
newValue
Новое значение
Строка
oldValue
Старое значение
Строка
ownerId
Идентификатор пользователя
Число
eserviceId
Идентификатор формы
Строка
заявления
currentStatusHistoryId
Идентификатор статуса
Число
заявления
hasTimestamp
Флаг timestamp
Логический
orderStatusName
Наименование статуса
Строка
заявления
portalName
Наименование портала
Строка
paymentRequired
Флаг наличия оплаты
Логический
paymentStatusEvents
Статус событий при оплате
Массив объектов
(для данных значений
параметра embed массив
будет пустой)
18
API ЕПГУ
payback
Служебный параметр
Логический
readyToPush
Служебный параметр
Логический
admLevelCode
Уровень услуги
Строка
(региональный/федеральный)
id
Номер заявления
Число
signCnt
Кол-во подписей, для
Число
заявлений от нескольких
заявителей
allFileSign
Флаг наличия ЭП для файлов
Логический
orgUserName
Наименование организации
Строка
пользователя
noPaidPaymentCount
Количество неоплаченных
Число
платежей
childrenSigned
Флаг подписи дочерних
Логический
заявлений
creationMode
Режим создания
Строка
powerMnemonic
Мнемоника полномочия, с
Строка
которым подается заявление
orderStatusId
Код статуса заявления
Число
withCustomResult
Признак необходимости
Логический
отображения кнопки в
Деталях заявления услуги
statuses
Статусы заявления (при
Массив
embed=STATUS_HISTORY)
date
Дата и время смены статуса
Строка дата и время
cancelAllowed
Флаг наличия отмены
Логический
unreadEvent
Признак прочтения
Логический
sendMessageAllowed
Признак разрешения
Логический
отправки сообщения
deliveryCancelAllowe
Флаг наличия отмены
Логический
d
доставки
statusId
Код статуса
Число
title
Наименование статуса
Строка
comment
Комментарий к статусу
Строка
19
API ЕПГУ
sender
Отправитель СМЭВ-
Строка
сообщения о смене статуса
mnemonic
Мнемоника ИС отправителя
Строка
orderId
Номер заявления
Число
editAllowed
Признак редактирования
Логический
hasResult
Флаг передачи файла в ответ
Строка
на заявление
id
Идентификатор статуса
Число
finalStatus
Флаг финального статуса
Логический
stateOrgStatusCode
Код ведомственного статуса
Строка
stateOrgStatusDescr
Наименование
Строка
ведомственного статуса
orderDate
Дата и время создания
Строка дата и время
заявления
updated
Дата и время обновления
Строка дата и время
статуса заявления
hasNoPaidPayment
Флаг наличия оплаченного
Логический
платежа
servicePassportId
Идентификатор паспорта
Строка
услуги
checkQueue
Флаг проверки очереди
Логический
withDelivery
Флаг доставки
Логический
gisdo
Признак подключенности
Логический
ведомства к ФГИС ДО
userSelectedRegion
Код ОКАТО
Строка
местоположения
пользователя
sourceSystem
Наименование системы от
Строка
куда было подано заявление
serviceUrl
Ссылка на заявление
Строка
eQueueEvents
Массив объектов
Массив объектов
eQueueEvent (для данных
значений параметра embed
20
API ЕПГУ
массив будет пустой)
hasActiveInviteToEqueue
Флаг записи на прием
Логический
multRegion
Признак регионозависимости
Логический
serviceEpguId
Идентификатор цели услуги
Строка
ЕПГУ
extSystem
Признак, что создано
Логический
внешней системой (через
сервис ЕЛК)
useAsTemplate
Флаг черновика заявления
Логический
edsStatus
Идентификатор статуса
Строка
проверки ЭП
allowToDelete
Флаг удаления заявки
Логический
qrlink
hasAltMimeType
Связанно с
Логический
alternativeMimeTypes из
сервиса тербайта
fileSize
Размер файла
Число
canSentToMFC
Флаг отправки в МФЦ
Логический
hasDigitalSignature
Флаг наличия ЭП
Логический
requestDate
Метка даты и времени
Строка
запроса
hasPreviewPdf
Флаг наличия пдф
Логический
hubFormVersion
Идентификатор
Число
регионозависимой формы
старого конструктора форм
stateOrgCode
Сокращенное наименование
Строка
ведомства
testUser
Флаг тестового пользователя
Логический
personType
Тип пользователя
Строка
textMessages
Информация о сообщениях
Массив объектов
(для данных значений
параметра embed массив
будет пустой)
serviceTargetId
Идентификатор цели
Строка
21
API ЕПГУ
orderPayments
Информация о платежах (для
Массив данных
данных значений параметра
embed массив будет пустой)
unreadMessageCnt
Кол-во непрочитанных
Число
сообщений
orderResponseFiles
Информация о файлах в
Массив данных
ответе заявления (при
embed=RESPONSE_FILE)
hasAltMimeType
Флаг наличия
Логический
альтернативного MIME-типа
fileName
Наименование файла
Строка
edsStatus
Статус проверки ЭП в EDS
Строка
fileSize
Размер файла
Число
link
Ссылка на файл в
Строка
TERRABYTE
id
Идентификатор файла
Строка
mimeType
MIME-тип файла
Строка
hasDigitalSignature
Флаг наличия ЭП к файлу
Логический
hasResult
Флаг передачи файла в ответ
Логический
на заявление
serviceName
Наименование цели
Строка
deprecatedService
Признак, что услуга больше
Логический
не заказывается
hubForm
Признак, что форма-
Логический
концентратор
userId
Идентификатор пользователя
Число
allowToEdit
Флаг редактирования
Логический
заявления
orderAttachmentFiles
Файлы заявления,
Массив данных
отправленные пользователем
(при embed=
ATTACHMENT_FILE)
fileName
Название файла
Строка
fileSize
Размер файла
Число
22
API ЕПГУ
hasDigitalSignature
Наличие подписи
Логический
id
Идентификатор файла
Строка
link
Ссылка на файл в хранилище
Строка
mimeType
MIME-тип
Строка
type
Тип
Строка
closed
Флаг наличия финального
Логический
статуса
online
Признак, онлайн услуга или
Логический
нет
readyToSign
Для ЮЛ, для подписания
Логический
заявки, Маркер ожидания
КЭП
currentStatusHistory
История статуса
Объект
date
Дата и время смены статуса
Строка дата и время
cancelAllowed
Флаг наличия отмены
Логический
unreadEvent
Признак прочтение события
Логический
deliveryCancelAllowe
Флаг наличия отмены
Логический
d
доставки
finalStatus
Флаг финального статуса
Логический
orderId
Номер заявления
Число
stateOrgStatusCode
Код ведомственного статуса
Строка
stateOrgStatusDescr
Наименование
Строка
ведомственного статуса
hasResult
Флаг передачи файла в ответ
Строка
на заявление
sendMessageAllowed
Признак разрешения
Логический
отправки сообщения
statusId
Код статуса
Число
title
Наименование статуса
Строка
editAllowed
Признак редактирования
Логический
sender
Наименование ведомства
Строка
comment
Комментарий
Строка
id
Идентификатор статуса
Число
23
API ЕПГУ
infoMessages
Информация о сообщениях
Массив данных
(для данных значений
параметра embed массив
будет пустой)
location
Код уровня услуги
Строка
paymentCount
Количество платежей
Число
draftHidden
Признак скрытия черновика
Логический
stateStructureId
Код ведомства
Строка
В случае успешного вызова возвращается ответ с http-код = 200.
http-код = 204 информирует, что заявление с указанным номером не найдено.
В случае ответа с http-код = 401 необходимо получить новый маркер доступа и
повторить запрос.
http-код = 403 информирует о том, что у пользователя нет прав для работы с
текущим заявлением.
В случае ответа с http-код = 400 необходимо проверить параметры запроса.
http-код = 409 информирует о невозможности обработать запрос.
Пример ответа при ошибке:
{
"code": "order_access",
"message": "У пользователя нет прав для работы с текущим заявлением"
}
6. Скачивание файла
Для скачивания файла необходимо вызвать следующий метод:
Таблица 26
Среда ЕПГУ
URL
Тестовая среда
beta.test.gosuslugi.ru/api/storage/v2/files/{objectId}/{objectType}/d
ownload?mnemonic={mnemonic}
Продуктивная среда
}/download?mnemonic={mnemonic}
Метод запроса: GET
24
API ЕПГУ
В заголовке Authorization запроса (тип Bearer) должен передаваться маркер
доступа со скоупом «http://lk.gosuslugi.ru/api-order».
{objectId} - currentStatusHistoryId заявления.
{objectType} - тип вложения (для файла с результатами по заявлению значение
3);
{mnemonic} - мнемоника файла.
Мнемонику и тип вложения можно найти в результате ответа от метода
получения деталей по заявлению (п.5). Параметр link будет содержать строку вида
«"terrabyte://.../…/ mnemonic/ objectType "».
7. Получение статусов заявлений
7.1. Получение статусов всех заявлений с даты обновления
статуса.
Для получения списка статусов заявлений с даты их последнего обновления,
необходимо вызвать следующий метод:
Таблица 27
Метод
URL
GET
/api/gusmev/order/getUpdatedAfter/?pageNum={n}&pageSize={m}
&updatedAfter={timestamp}
В заголовке Authorization запроса (тип Bearer) должен передаваться маркер
доступа со скоупом «http://lk.gosuslugi.ru/api-order».
pageNum={n} - номер запрашиваемой страницы.
pageSize={m} - количество записей на странице
updatedAfter={timestamp} - дата и время, после которых были обновлены
статусы
В случае положительного ответа (http-код = 200) в теле возвращается JSON
объект с параметрами, которые предусмотрены для переданного типа значений:
Таблица 28
Параметр
Описание
Тип
Обязательно
сть
count
Количество записей,
Число
Да
содержащихся в массиве
25
API ЕПГУ
Параметр
Описание
Тип
Обязательно
сть
Content
totalCount
Количество найденных записей,
Число
Да
подходящих под условие
content
Массив записей
Массив
Да
orderId
Номер заявления
Число
Да
orderSearchStatus
Признак нахождения статуса
Строка
Да
заявления. Может принимать
значение FOUND/
NOT_FOUND
status
Информация о последнем
Массив
Нет
статусе заявления
statusId
Код статуса
Число
Да
statusName
Наименование последнего
Строка
Да
статуса
updated
Дата и время последнего
timestamp
Да
обновления статуса
В случае ответа с http-код
400 (неверные параметры),
409 (невозможно
обработать запрос) или 500 (внутренняя ошибка) в теле возвращается JSON объект со
следующими параметрами:
Таблица 29
Параметр
Описание
Тип
Обязательно
сть
code
Код ошибки
Строка
Нет
message
Текст ошибки
Строка
Нет
В случае ответа с http-код = 401 необходимо получить новый маркер доступа и
повторить запрос.
7.2. Получение статусов заявлений по переданному списку
заявлений.
Для получения статусов по списку заявлений, необходимо вызвать следующий
метод:
Таблица 30
Метод
URL
GET
/api/gusmev/order/getOrdersStatus/?pageNum={n}&pageSize={m}
26
API ЕПГУ
pageNum={n} - количество возвращаемых страниц.
pageSize={m} - количество записей на странице,
orderIds={array[integer]} - номера заявлений.
В заголовке Authorization запроса (тип Bearer) должен передаваться маркер
доступа со скоупом «http://lk.gosuslugi.ru/api-order».
В заголовке запроса необходимо передавать Content-Type = application/json.
В случае положительного ответа (http-код = 200) в теле возвращается JSON
объект с параметрами, которые предусмотрены для переданного типа значений:
Таблица 31
Параметр
Описание
Тип
Обязательно
сть
count
Количество записей,
Число
Да
содержащихся в массиве
Content
totalCount
Количество найденных записей,
Число
Да
подходящих под условие
content
Массив записей
Массив
Да
orderId
Номер заявления
Число
Да
orderSearchStatus
Признак нахождения статуса
Строка
Да
заявления.
Может принимать значение
FOUND/ NOT_FOUND
status
Информация о последнем
Массив
Нет
статусе заявления
statusId
Код статуса
Число
Да
statusName
Наименование последнего
Строка
Да
статуса
updated
Дата и время последнего
timestamp
Да
обновления статуса
В случае ответа с http-код
400 (неверные параметры),
409 (невозможно
обработать запрос) или 500 (внутренняя ошибка) в теле возвращается JSON объект со
следующими параметрами:
Таблица 33
Параметр
Описание
Тип
Обязательно
сть
code
Код ошибки
Строка
Нет
message
Текст ошибки
Строка
Нет
27
API ЕПГУ
В случае ответа с http-код = 401 необходимо получить новый маркер доступа и
повторить запрос.
8. Примеры запросов и ответов
8.1. Создание заявления
Пример запроса:
Тело запроса:
{
"region":"36",
"serviceCode":"10000000113",
"targetCode":"-10000000113",
}
Пример положительного ответа:
{
"orderId": 52353456
}
Пример отрицательного ответа:
{
"code": "access_denied_system",
"message": "Доступ запрещен для системы"
}
8.2. Получение справочных данных
Пример запроса:
Тело запроса:
{
"treeFiltering": "ONELEVEL",
"pageNum": 1,
"pageSize": 2
}
Пример положительного ответа:
{
"error": {
"code": 0,
"message": "operation completed"
},
"fieldErrors": [],
"total": 899,
"items": [
{
28
API ЕПГУ
"value": "040001002",
"parentValue": null,
"title": "ПУ БАНКА РОССИИ N 43192",
"isLeaf": true,
"children": [],
"attributes": [],
"source": null,
"attributeValues": {}
},
{
"value": "040002002",
"parentValue": null,
"title": "ПУ БАНКА РОССИИ N 43197",
"isLeaf": true,
"children": [],
"attributes": [],
"source": null,
"attributeValues": {}
}
]
}
8.3. Загрузка архива
Пример запроса:
Пример form-data запроса:
Параметр
Значение
meta
{"region":"36",
"serviceCode":"10000000113",
"targetCode":"-10000000113"}
file
arch.zip
Пример положительного ответа:
{
"orderId": 2058864134
}
Пример отрицательного ответа:
{
"code": "access_denied_person_permissions",
"message": "Пользователь не дал согласие Вашей системе на выполнение данной
операции"
29
API ЕПГУ
}
8.4. Загрузка архива по частям
Пример запроса отправки первого чанка:
Пример form-data запроса:
Параметр
Значение
orderId
764255248
file
Пример ответа:
{
"orderId": 764255248
}
Status: 206
Пример запроса отправки второго и последующих чанков:
Пример form-data запроса:
Параметр
Значение
orderId
764255248
file
Пример ответа:
{
"orderId": 764255248
}
Status: 206
Пример запроса последнего чанка:
30
API ЕПГУ
Пример form-data запроса:
Параметр
Значение
orderId
764255248
file
arch.zip
Пример ответа:
{
"orderId": 764255248
}
Status: 200
8.5. Отмена заявления
Пример запроса:
Пример ответа:
http-код = 200 - заявление отменено
http-код = 403 - у пользователя нет прав для этого действия
http-код = 404 - заявление не найдено
http-код = 405 - отмена невозможна
http-код = 401 - необходимо получить новый маркер доступа и повторить запрос
8.6. Получение деталей по заявлению
Пример запроса:
Пример ответа:
{
"code": "OK",
"message": null,
"order":
"{\"orderType\":\"ORDER\",\"smevTx\":\"b0ba0139-613d-4d4d-bc28-
4240efc9a6ec\",\"hasEmpowerment2021\":false,\"smevMessageId\":\"WAIT_RESPON
SE\",\"formVersion\":\"1\",\"ownerId\":1078941357,\"notifySms\":\"\",\"hasTimestamp
\":false,\"orderStatusName\":\"Ошибка
обработки
заявления\",\"portalName\":\"Портал
гос
услуг
31
API ЕПГУ
v1\",\"paymentRequired\":false,\"id\":2058864134,\"signCnt\":0,\"childrenSigned\":fals
e,\"stateOrgStatusCode\":\"\",\"inviteToEqueueUrl\":\"\",\"statusColorCode\":\"\",\"orde
rStatusId\":24,\"withCustomResult\":true,\"hasNoPaidPayment\":false,\"servicePassport
Id\":\"600113\",\"routingCode\":\"\",\"sourceSystem\":\"PGU\",\"stateOrgStatusName\"
:\"\",\"serviceUrl\":\"\",\"serviceEpguId\":\"1\",\"edsStatus\":\"EDS_NOT_SUPPORTE
D\",\"allowToDelete\":true,\"requestDate\":\"2022-07-
25T13:01:47.438+0300\",\"complexMode\":\"\",\"stateOrgCode\":\"pfr\",\"personType\
":\"PERSON\",\"serviceTargetId\":\"-
10000000113\",\"orderPayments\":[],\"orderResponseFiles\":[],\"hasResult\":false,\"use
rId\":1078941357,\"allowToEdit\":false,\"closed\":true,\"readyToSign\":false,\"currentS
tatusHistory\":{\"date\":\"2022-07-
25T13:01:52.121+0300\",\"cancelAllowed\":false,\"unreadEvent\":true,\"deliveryCance
lAllowed\":false,\"finalStatus\":true,\"orderId\":2058864134,\"stateOrgStatusCode\":\"\
",\"author\":\"\",\"hasResult\":\"N\",\"stateOrgStatusDescr\":\"\",\"title\":\"Ошибка
обработки
заявления\",\"mfcFinalStatus\":false,\"sendMessageAllowed\":false,\"statusId\":24,\"ed
itAllowed\":false,\"sender\":\"Пенсионный
фонд
Российской
Федерации\",\"mnemonic\":\"\",\"comment\":\"\",\"id\":6268157772},\"infoMessages\"
:[],\"notifyEmail\":\"\",\"paymentCount\":0,\"draftHidden\":false,\"stateStructureId\":\"1
0000002796\",\"hasNewStatus\":true,\"stateOrgId\":266,\"redirectUrl\":\"\",\"hasChildre
n\":false,\"stateStructureName\":\"ПФР\",\"portalCode\":\"PGU\",\"esepOperationId\":\
"\",\"orderAttributeEvents\":[],\"notifyPush\":\"\",\"eserviceId\":\"10000000113\",\"curr
entStatusHistoryId\":6268157772,\"linkToOrderForm\":\"\",\"extOrderUrl\":\"\",\"paym
entStatusEvents\":[],\"payback\":false,\"readyToPush\":false,\"admLevelCode\":\"FED
ERAL\",\"formPrefilling\":false,\"allFileSign\":false,\"orgUserName\":\"\",\"noPaidPay
mentCount\":-
1,\"creationMode\":\"direct\",\"steps\":[],\"powerMnemonic\":\"\",\"statuses\":[{\"date\"
:\"2022-07-
25T13:01:46.413+0300\",\"cancelAllowed\":false,\"unreadEvent\":true,\"deliveryCance
lAllowed\":false,\"finalStatus\":false,\"orderId\":2058864134,\"stateOrgStatusCode\":\"\
",\"author\":\"\",\"hasResult\":\"N\",\"stateOrgStatusDescr\":\"\",\"title\":\"Черновик
заявления\",\"mfcFinalStatus\":false,\"sendMessageAllowed\":false,\"statusId\":0,\"edit
Allowed\":false,\"sender\":\"\",\"mnemonic\":\"\",\"comment\":\"\",\"id\":6268157768},
{\"date\":\"2022-07-
25T13:01:47.426+0300\",\"cancelAllowed\":false,\"unreadEvent\":true,\"deliveryCance
lAllowed\":false,\"finalStatus\":false,\"orderId\":2058864134,\"stateOrgStatusCode\":\"\
",\"author\":\"\",\"hasResult\":\"N\",\"stateOrgStatusDescr\":\"\",\"title\":\"Зарегистрир
овано
на
портале\",\"mfcFinalStatus\":false,\"sendMessageAllowed\":false,\"statusId\":17,\"edit
Allowed\":false,\"sender\":\"Пенсионный
фонд
Российской
Федерации\",\"mnemonic\":\"\",\"comment\":\"\",\"id\":6268157769},{\"date\":\"2022-
07-
25T13:01:48.520+0300\",\"cancelAllowed\":false,\"unreadEvent\":true,\"deliveryCance
lAllowed\":false,\"finalStatus\":false,\"orderId\":2058864134,\"stateOrgStatusCode\":\"\
",\"author\":\"\",\"hasResult\":\"N\",\"stateOrgStatusDescr\":\"\",\"title\":\"Заявление
32
API ЕПГУ
отправлено
в
ведомство\",\"mfcFinalStatus\":false,\"sendMessageAllowed\":false,\"statusId\":21,\"e
ditAllowed\":false,\"sender\":\"Пенсионный
фонд
Российской
Федерации\",\"mnemonic\":\"\",\"comment\":\"\",\"id\":6268157770},{\"date\":\"2022-
07-
25T13:01:51.810+0300\",\"cancelAllowed\":false,\"unreadEvent\":true,\"deliveryCance
lAllowed\":false,\"finalStatus\":false,\"orderId\":2058864134,\"stateOrgStatusCode\":\"\
",\"author\":\"\",\"hasResult\":\"N\",\"stateOrgStatusDescr\":\"\",\"title\":\"Заявление
получено
ведомством\",\"mfcFinalStatus\":false,\"sendMessageAllowed\":false,\"statusId\":2,\"e
ditAllowed\":false,\"sender\":\"Пенсионный
фонд
Российской
Федерации\",\"mnemonic\":\"\",\"comment\":\"Сообщение
доставлено\",\"id\":6268157771},{\"date\":\"2022-07-
25T13:01:52.121+0300\",\"cancelAllowed\":false,\"unreadEvent\":true,\"deliveryCance
lAllowed\":false,\"finalStatus\":true,\"orderId\":2058864134,\"stateOrgStatusCode\":\"\
",\"author\":\"\",\"hasResult\":\"N\",\"stateOrgStatusDescr\":\"\",\"title\":\"Ошибка
обработки
заявления\",\"mfcFinalStatus\":false,\"sendMessageAllowed\":false,\"statusId\":24,\"ed
itAllowed\":false,\"sender\":\"Пенсионный
фонд
Российской
Федерации\",\"mnemonic\":\"\",\"comment\":\"\",\"id\":6268157772}],\"orderDate\":\"
2022-07-25T13:01:46.000+0300\",\"updated\":\"2022-07-
25T13:01:52.129+0300\",\"checkQueue\":false,\"withDelivery\":false,\"gisdo\":false,\"u
serSelectedRegion\":\"00000000000\",\"description\":\"\",\"eQueueEvents\":[],\"hasActi
veInviteToEqueue\":false,\"multRegion\":false,\"extSystem\":false,\"useAsTemplate\":f
alse,\"qrlink\":{\"hasAltMimeType\":false,\"fileName\":\"\",\"edsStatus\":\"\",\"fileSize\
":0,\"canSentToMFC\":false,\"link\":\"\",\"id\":\"\",\"mimeType\":\"\",\"hasDigitalSigna
ture\":false,\"additionalName\":\"\"},\"hasPreviewPdf\":false,\"testUser\":false,\"textMe
ssages\":[],\"unreadMessageCnt\":0,\"parentOrderStateStructureName\":\"\",\"cr_uin\":\
"\",\"infSysCode\":\"\",\"serviceName\":\"Выдача справки о размере пенсии и иных
социальных
выплат
на
дату\",\"deprecatedService\":false,\"hubForm\":false,\"extOrderId\":\"\",\"orderAttachm
entFiles\":[{\"fileName\":\"req.xml\",\"fileSize\":653,\"link\":\"terrabyte://00/20588641
34/req.xml/2\",\"id\":\"2058864134/files/cmVxLnhtbA\",\"mimeType\":\"application/x
ml\",\"hasDigitalSignature\":false,\"type\":\"REQUEST\"}],\"online\":false,\"location\":
\"36\"}"
}
8.7. Получение статусов заявлений
Пример запроса статусов всех заявлений с даты обновления статуса:
GET https://svcdev-
beta.test.gosuslugi.ru/api/gusmev/order/getUpdatedAfter/?pageNum=0&pageSize=5&upda
tedAfter=2022-12-10T12:31:42.000
33
API ЕПГУ
Пример ответа:
{
"count": 5,
"totalCount": 40,
"content": [
{
"orderId": 764607248,
"orderSearchStatus": "FOUND",
"status": {
"statusId": 24,
"statusName": "Ошибка отправки заявления в ведомство",
"updated": "2022-12-21T20:49:37.672"
}
},
{
"orderId": 764603930,
"orderSearchStatus": "FOUND",
"status": {
"statusId": 15,
"statusName": "Заявление требует исправления",
"updated": "2022-12-21T19:51:16.852"
}
},
{
"orderId": 764602932,
"orderSearchStatus": "FOUND",
"status": {
"statusId": 4,
"statusName": "Истекло время подписания документов",
"updated": "2022-12-16T15:31:42.083"
}
},
{
" orderId": 2354270898,
"orderSearchStatus": "NOT_FOUND",
"status": null
},
{
"orderId": 2354271090,
"orderSearchStatus": "NOT_FOUND",
"status": null
}
]
}
Пример запроса статусов по списку заявлений:
GET https://svcdev-
beta.test.gosuslugi.ru/api/gusmev/order/getOrdersStatus/?orderIds=764607248,764603930,
764602932,2312621299,2312620698&pageNum=0&pageSize=5
34
API ЕПГУ
Пример ответа:
{
"count": 5,
"totalCount": 5,
"content": [
{
"orderId": 764607248,
"orderSearchStatus": "FOUND",
"status": {
"statusId": 24,
"statusName": "Ошибка отправки заявления в ведомство",
"updated": "2022-12-21T20:49:37.672"
}
},
{
"orderId": 764603930,
"orderSearchStatus": "FOUND",
"status": {
"statusId": 15,
"statusName": "Заявление требует исправления",
"updated": "2022-12-21T19:51:16.852"
}
},
{
"orderId": 764602932,
"orderSearchStatus": "FOUND",
"status": {
"statusId": 4,
"statusName": "Истекло время подписания документов",
"updated": "2022-12-16T15:31:42.083"
}
},
{
"orderId": 2312621299,
"orderSearchStatus": "NOT_FOUND",
"status": null
},
{
"orderId": 2312620698,
"orderSearchStatus": "NOT_FOUND",
"status": null
}
]
}
35
API ЕПГУ
История изменений документа
Версия
Дата
Имя автора
Комментарий
1.0
01.10.2021
Куделина А.В.
Первая версия документа
1.1
15.12.2021
Куделина А.В.
Дополнены разделы 3.1, 4, 5, 7, 8
1.2
29.12.2021
Куделина А.В.
Отредактированы разделы 5, 8
1.3
27.04.2022
Трубников А.Л.
Отредактированы разделы 3.2, 3.4, 6
1.4
27.06.2022
Лютенков А.В.
Отредактированы разделы 2, 3, 4, 5, 6, 7.
Удален раздел 6 в предыдущей редакции (в
новой редакции разделы 6 и 7 соответствуют
разделам 7 и 8 предыдущей редакции).
1.5
20.07.2022
Лютенков А.В.
Множественные правки всего документа,
таблиц. Составление новой схемы процесса
подачи заявления.
1.6
01.09.2022
Трубников А.Л.
Добавлено описание минимального размера
чанка. Добавлено описание размера
последнего чанка.
1.7
23.09.2022
Трубников А.Л.
В разделе 1 поправлены названия
регламентов, размещенных на странице
Добавлено название указанного в примере
метода ЕСИА.
1.8
21.10.2022
Лютенков А.В.
Исправление ошибок предыдущих правок:
1. в параграф 3.1. в части описания
процесса подачи заявления;
2. в параграф 3.1. в части описания
назначения методов /order и /push
(таблица № 5);
3. в параграф 3.4. в части описания метода
/push/chunked (корректировка о том, что
наименования файлов должно
соответствовать правилам, указанным в
спецификации по конкретной услуге);
4. в параграф 3.4. в части размеров чанков
метода /push/chunked;
5. изменена структура, добавлен новый
параграф 3.2 про взаимодействие по
ГОСТ TLS, нумерация параграфов в 3
разделе, начиная с 3.2 предыдущей
редакции смещена на 1.
1.9
19.12.2022
Трубников А.Л.
В разделе 3.2 убрано описание подключения
без ГОСТ TLS. Добавлено описание средств
криптографической защиты.
В разделе 3.5 добавлено описание:
36
API ЕПГУ
Версия
Дата
Имя автора
Комментарий
требований к архиву;
нумерации чанков.
Добавлено общее описание документа.
В раздел 7.4 добавлены примеры отправки
архива несколькими чанками.
1.10
26.12.2022
Трубников А.Л.
Добавлен раздел 7 - «Получение статусов
заявлений»
Добавлен раздел 8.7 - «Примеры получения
статусов заявлений»
1.11
10.03.2023
Могилевская
Отредактированы разделы 7 и 8.7 для
С.В
методов getUpdatedAfter и getOrdersStatus.
Методы были изменены с POST на GET.
37