Проект автоматизации взаимодействия с API Единого портала государственных услуг (ЕПГУ): подача заявлений, подписание документов через КриптоПро, получение статусов и ответных документов.
Документация и справочники услуг сверены с Порталом API Госуслуг. Дата актуализации: 2026-05-12. Реализация ориентирована на спецификацию API ЕПГУ v1.13 (с учётом правок v1.12.1 по разделам ГОСТ TLS / СМЭВ4).
| Каталог | Назначение |
|---|---|
| api-gosuslugi-backend/ | FastAPI-сервис: КриптоПро, подпись, проксирование вызовов ЕПГУ |
| api-gosuslugi-client/ | React-приложение (Ant Design): UI для подачи заявлений |
| docs/ | Архитектура, схемы XML, API, диаграммы Mermaid, регламенты ЕПГУ |
| habr/ | Статьи для публикации на Хабре |
| step/ | Пошаговые инструкции с иллюстрациями (настройка ИС, сертификатов) |
cp .env .env.local # заполнить apikey, KeyPin и пр.
docker-compose up -d --build- Фронтенд: http://localhost:5080
- Бэкенд (Swagger): http://localhost:5000/docs
Подробные сценарии установки и использования - в HOWTO.md.
flowchart LR
U[Пользователь] --> FE[React / Nginx :5080]
FE -->|/api| BE[FastAPI :5000]
BE -->|pycades| CP[КриптоПро CSP]
BE -->|HTTPS + JWT| ESIA[ЕСИА / ЕПГУ API]
Полная архитектура - в docs/architecture.md.
- Авторизация - организация-потребитель получает JWT-токен через ЕСИА, используя API-ключ и подпись КриптоПро.
- Создание заявления - генерация XML по спецификации ЕПГУ, подпись КриптоПро (CAdES-BES), отправка через API.
- Обработка ответов - статусы поданных заявлений, загрузка ответных документов.
- Работа с сертификатами - список, выбор активного, отображение субъекта.
- Администрирование - управление API-ключами, услугами (через переменную
SERVICES). - Конфигурация сред - переключение между тестовым контуром (
*.test.gosuslugi.ru) и продом (esia.gosuslugi.ru/lk.gosuslugi.ru) через.env.
| Код | Описание | Источник спецификации |
|---|---|---|
60010153 |
Наличие исполнительного производства (ФССП) | Prilozhenie_60010153_Nalichie_IP_v8.docx |
10000000367 |
Подача заявлений / ходатайств / объяснений | Specifikaciya_API_EPGU_Podacha_zayavlenij_..._10000000367_18_06_2024.docx |
10000000109 |
Доставка пенсии и социальных выплат ПФР/СФР | partners.gosuslugi.ru/catalog/api_for_gu |
60010154 |
Предоставление информации о ходе ИП (ФССП) | Specifikaciya_API_EPGU_Predostavlenie_informacii_o_hode_IP_v_7.docx |
Полный каталог, среды и endpoint-ы - в docs/SERVICES.md.
- Docker / Docker Compose
- КриптоПро CSP (устанавливается в backend-образ), сертификат и закрытый ключ организации
- API-ключ организации-потребителя ЕПГУ - получение описано в локальном
docs/Rukovodstvo_polzovatelya_dlya_organizacii-potrebitelya_...docx
- docs/README.md - указатель по всей документации
- docs/SERVICES.md - каталог услуг и спецификаций (актуально на 2026-05-12)
- docs/architecture.md - компоненты и потоки
- docs/api.md - справочник эндпоинтов
- docs/schemas.md - XML/XSD и модели данных
- docs/deployment.md - развёртывание
- docs/sequence-diagrams.md - последовательности
- habr/ - статьи
MIT - см. LICENSE.