Revert to this revision

Введение

О проекте

Проект ГосПлан представляется собой набор сервисов, направленных на интеграцию с государственными закупками. Проект запущен в 2018м году. Базовыми публичными сервисами проекта ГосПлан являются веб-сервисы, которые предоставляют API к документам Единой информационной системе в сфере закупок (ЕИС Закупки, https://zakupki.gov.ru). Данный ресурс описывает вторую версию API, который запущен в 2025 году. Информация об API v1 приведена здесь.

Возможности API

Сервис предоставляет следующие данные:

  • по 44-ФЗ: планы-графики закупок, закупки (извещения, протоколы и др. документы), процедуры заключения контрактов, контракты. Начало загрузки документов - 01.01.2024.
  • по 223-ФЗ: планы закупок, закупки (извещения, протоколы и др. документы), договоры. Начало загрузки документов - 01.10.2024.
  • по ПП РФ 615: закупки (извещения, протоколы и др. документы), контракты. Начало загрузки документов - 01.01.2025.

Ориентировочный период хранения данных - 3 года.

Состав сервиса

  • Продуктивный сервер - https://v2.gosplan.info. Сервер предоставляет данные по REST протоколу. Для получения данных требуется API ключ (c 01.07.2025).
  • Тестовый сервер - https://v2test.gosplan.info. Почти тоже самое, что и продуктивный сервер с количественными ограничениями по запросам. Для получения данных API ключ НЕ требуется. Рекомендуется использовать для демонстрационных целей, быстрого страта, работы в swagger https://swagger.gosplan.info.
  • Описание API методов - https://swagger.gosplan.info. Содержит подпробное описание API методов, а также историю изменений

Архитектура сервиса

Сервис предоставляет JSON-данные по REST-протоколу и реализован на Python3 с использованием FastAPI. API обеспечивает обработку входящих запросов с высокой производительностью и удобным документированием. Запросы обрабатываются синхронно, а выполнение сложных вычислений делегируется фоновым процессам.

Для хранения данных используется MongoDB, выступающая в роли основного хранилища. В базе данных содержатся как оперативные, так и исторические данные, а также метаданные для внутренней обработки.

В качестве промежуточного хранилища для больших объемов данных, временных файлов и резервных копий используется S3-совместимое хранилище. Оно применяется для обмена данными между сервисами, а также для хранения подготовленных файлов перед загрузкой в основную базу данных.

Фоновая обработка данных, включая их загрузку, очистку и агрегацию, управляется системой Apache Airflow, которая организует выполнение задач в виде DAG (Directed Acyclic Graph).

Развертывание и обновление сервисов осуществляется с помощью ArgoCD, который отслеживает изменения в репозитории конфигураций и автоматически применяет их в Kubernetes-кластере. Это позволяет реализовать GitOps-подход и обеспечить предсказуемость обновлений.

Для обеспечения отказоустойчивости в случае инфраструктурных сбоев у основного провайдера сервис поддерживает Disaster Recovery (DR) окружение. DR-окружение развернуто в альтернативном дата-центре и синхронизируется с основной системой. При возникновении проблем с доступностью основной инфраструктуры выполняется автоматическое переключение на резервный контур с минимальным временем простоя.

Полезные ссылки

Начало работы

Регистрация и аутентификация

В настоящее время регистрация и аутентификациия к продуктовому серверу https://v2.gosplan.info не требуется. Доступ к API предоставляется на свободной основе до 01.07.2025. После окончания бесплатного периода доступ будет осуществляться по API ключу.

Информация о получении и использовании API ключа будет опубликована в ближайшее время.

Доступ к тестовому серверу https://v2test.gosplan.info подразумевается без регистрации и аутентификации, но с ограничениями по количеству запросов.

Инструкции

Документы

Обмен данными в ЕИС производится в формате XML с использованием протокола AS2 (http://www.ietf.org/rfc/rfc4130.txt). Разделы информационной системы содержат различные XML-документы с различной структурой. Ниже приводится описание докумнетов, которые предоставляются через ГосПлан API.

Типы документов

Справочники

Раздел содержит полезные справочные данные, которые используются в API

Правовые документы и реквизиты

Контакты

По всем вопросам работы сервисов ГосПлан API v2 обращайтесь по контактным данным ниже: