go-api-epgu

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

Методы

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

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

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

Услуги API ЕПГУ

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

Примеры

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

Установка

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

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

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

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

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

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

1. Портал API Госуслуг: регламенты подключения, руководства, спецификация API ЕПГУ и отдельных услуг
2. Методические рекомендации по интеграции с REST API Цифрового профиля
3. Методические рекомендации по использованию ЕСИА
4. Руководство пользователя ЕСИА
5. Руководство пользователя технологического портала ЕСИА

Ссылки

ЕСИА

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

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

• Тестовая среда (SVCDEV): 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.12.1", раздел "1.2. Реализация подключения по ГОСТ TLS"

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

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

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

• Тестовая среда (SVCDEV): https://lkuv.gosuslugi.ru/paip-portal/#/podd/open-api/specifications/card/e28f1ae0-0fdc-431a-9adb-17173564d1db
• Продуктовая среда: на 16 мая 2024 "Спецификация API ЕПГУ" не опубликована в промышленной среде СМЭВ 4.

СМЭВ4

• Документы СМЭВ 4 (ПОДД): регламенты подключения, руководство администратора, дистрибутив Агента ПОДД
• Коротко о СМЭВ 4 (ПОДД)
• Обмен в СМЭВ4 c использованием REST-сервиса
• Материалы по теме "СМЭВ 4 (ПОДД)"

Лицензия

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