Введение

О проекте

Проект ГосПлан представляется собой набор сервисов, направленных на интеграцию с государственными закупками. Проект запущен в 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 методов, а также историю изменений.
  • Статусная страница - https://stats.uptimerobot.com/FCAeTgC4tf страница с состоянием доступности основных сервисов.

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

Сервис предоставляет 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 подразумевается без регистрации и аутентификации, но с ограничениями по количеству запросов.

Быстрый старт

Здесь вы найдете всю необходимую информацию для того, чтобы начать работу с ГосПлан API v2 за считанные минуты. Подготовлены простые инструкции, которые помогут вам протестировать функциональность сервиса через командную строку, язык программирования python, а так же с использованием Swagger — удобного инструмента для взаимодействия с API.

Для выполнения запросов не требуется регистрация и аутентификация.

Быстрый старт для:

Лимиты и тарифы

Продуктовый сервер

На текущий момент доступен единственный тарифный план для продуктового сервера https://v2.gosplan.info, подходящий для большинства пользователей. Тариф начнет действовать с 01 июля 2025 года.

Базовый тариф

  • Стоимость: 3 000 ₽/месяц
  • Лимит запросов: 6 000 запросов за 10 минут
  • Тип лимита: Оконное скользящее ограничение (rolling window)
  • Доп. запросы: Не предусмотрены (превышение лимита приводит к ошибке 429 Too Many Requests)

Как считается лимит?

Система отслеживает количество запросов за последние 10 минут. Например:

  • Если в 12:00 вы отправили 6 000 запросов, то новые запросы будут отклоняться до 12:10
  • В 12:01 учитываются только запросы, сделанные с 11:51 до 12:01

Тестовый сервер

Доступ к тестовому серверу https://v2test.gosplan.info с учетом следующих условий:

  • Стоимость: бесплатно
  • Лимит запросов: 10 запросов за 1 минуту
  • Тип лимита: Оконное скользящее ограничение (rolling window)
  • Доп. запросы: Не предусмотрены (превышение лимита приводит к ошибке 429 Too Many Requests)

Тариф начнет действовать с 01 июля 2025 года.

Лимит рассчитывается аналогичным образом.

Документация API

Инструкции и руководства

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

Справочники

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

Частые вопросы

Сколько стоит?

Стоимость доступа и ограничения на запросы указаны в разделе Лимиты и тарифы

Когда загружаются новые данные?

Сервис загружает данные из ЕИС ежедневно с 03-00 МСК до 09-00 МСК за предыдущий день. Если документ опубликован на сайте https://zakupki.gov.ru условного сегодня, то в API этот документ появится условно завтра после 09-00 МСК. Обозначенный интервал времени разделяется на временные слоты, в которых загружаются различные типы документов.

Интервал времени, МСК Раздел
03:00 - 04:15 Закупки по 44-ФЗ
04:15 - 05:30 Контракты по 44-ФЗ
05:30 - 05:45 Планы-графики по 44-ФЗ
05:45 - 07:00 Контрактные процедуры по 44-ФЗ
07:00 - 08:15 Закупки по 223-ФЗ
08:15 - 08:30 Договоры по 223-ФЗ
08:30 - 08:45 Планы закупок по 223-ФЗ
08:45 - 09:00 Закупки и контракты по ПП РФ 615

Почему мой документ не найден?

Документ может отсутствовать по следующим причинам:

  1. Некорректный идентификатор документа, который передается в запросе
  2. Документ еще не загружен в API (см. вопрос Когда загружаются данные?)
  3. Документ не попадает под дату начала загрузки и глубину хранения (подробно в разделе Введение)
  4. Ошибка в работе сервиса. Свяжитесь с нами, контакты ниже.

А если лимитов тарифов не достаточно?

Опишите ваши потребности по координатам в разделе Контакты. Ваш вопрос будет проработан и предложены варианты решений.

Можно ли запросить изменение API?

Запросы на изменения API рассматриваются в порядке очередности и с учетом наличия свободных ресурсов. Приоритет отдается клиентам с оплаченными тарифами.

Юридическая информация

Контакты

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