go-api-epgu

REST-клиент для работы с API Госуслуг (ЕПГУ). Разработан в соответствии с документом «Спецификация API ЕПГУ, версия 1.14»

Методы

• Client.OrderCreate — резервирование номера заявления
• Client.OrderPushChunked — загрузка и отправка заявления после резервирования номера
• Client.OrderPush — загрузка и отправка заявления одним запросом
• Client.OrderInfo — запрос детальной информации по отправленному заявлению
• Client.GetOrdersStatus — получение статусов заявлений по списку заявлений
• Client.GetUpdatedAfter — получение статусов заявлений с даты обновления статуса
• Client.OrderCancel — отмена заявления
• Client.AttachmentDownload — скачивание файла
• Client.Dict — получение справочных данных

Запрос согласия и получение маркера доступа ЕСИА

• esia/aas — OAuth2-клиент для получения маркера доступа ЕСИА
• esia/signature — подпись запросов к ЕСИА

Услуги API ЕПГУ

• services/sfr/zdp-10000000109 — "Доставка пенсии и социальных выплат ПФР"

Примеры

• Запрос согласия пользователя и получения маркера доступа
• Обновление маркера доступа
• Резервирование номера заявления и загрузка архива по частям
• Получение детальной информации по отправленному заявлению

Установка

go get -u github.com/ofstudio/go-api-epgu

Системные требования

• Go 1.21+
• Для подписания запросов к ЕСИА с помощью LocalCryptoPro — КриптоПро CSP 5.0+, ключ и сертификат для подписания запросов

Регламентные требования

1. Информационная система должна быть зарегистрирована на Технологическом портале ЕСИА: продуктовом или тестовом (ТЕСИА)
2. Для ИС должен быть выпущен необходимый сертификат
3. Публичная часть сертификата должна быть загружена на Технологический портал ЕСИА
4. Выполнены все необходимые шаги регламента и согласованы заявки на подключения ИС к тестовым или продуктовым средам ЕСИА и ЕПГУ

Руководящие документы

1. Портал API Госуслуг: регламенты подключения, руководства, спецификация API ЕПГУ и отдельных услуг
2. Методические рекомендации по использованию ЕСИА
3. Методические рекомендации по интеграции с REST API Цифрового профиля
4. Сценарии использования инфраструктуры цифрового профиля физического лица
5. Регламент информационного взаимодействия ЕСИА
6. Руководство пользователя технологического портала ЕСИА
7. Руководство пользователя ЕСИА
8. Документы: Межведомственное электронное взаимодействие
9. Документы: СМЭВ4: регламенты, руководство администратора, дистрибутив Агента ПОДД
10. Документы: ПО для Участников СМЭВ
11. Обмен в СМЭВ4 c использованием REST-сервиса

Ссылки

ЕСИА

• Тестовая среда (ТЕСИА): https://esia-portal1.test.gosuslugi.ru
• Продуктовая среда: https://esia.gosuslugi.ru

Технологический портал ЕСИА

• Тестовая среда (ТЕСИА): https://esia-portal1.test.gosuslugi.ru/console/tech
• Продуктовая среда: https://esia.gosuslugi.ru/console/tech/

Список согласий предоставленных пользователем

• Тестовая среда (SVCDEV): https://svcdev-betalk.test.gosuslugi.ru/settings/third-party/agreements/acting
• Продуктовая среда: https://lk.gosuslugi.ru/settings/third-party/agreements/acting

Подключение

Подключение через TLS

Прямое подключение к API ЕПГУ через TLS-соединение. Подробнее см "Спецификация API ЕПГУ версия 1.14", раздел "1.2. Реализация подключения по ГОСТ TLS"

• Тестовая среда (SVCDEV): https://svcdev-beta.test.gosuslugi.ru
• Продуктовая среда: https://lk.gosuslugi.ru

Подключение через СМЭВ4 (Агент ПОДД)

Подключение через регламентированный запрос типа REST-сервис в среде СМЭВ4. Подробнее см "Спецификация API ЕПГУ версия 1.14", раздел "1.3. Подключение через СМЭВ 4".

• Тестовая среда (SVCDEV): https://nsud.gosuslugi.ru/pud/paip-portal/#/podd/open-api/specifications/card/e28f1ae0-0fdc-431a-9adb-17173564d1db
• Продуктовая среда: https://nsud.gosuslugi.ru/pud/paip-portal/#/podd/open-api/specifications/card/936fbb29-07bb-4206-8374-395eb2bd36b0

Лицензия

Распространяется по лицензии MIT. Более подробная информация в файле LICENSE.