Введение

О проекте

Проект ГосПлан представляется собой набор сервисов, направленных на интеграцию с государственными закупками. Проект запущен в 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 ₽/месяц
  • Лимит запросов: 600 запросов в минуту
  • Тип лимита: Оконное скользящее ограничение (rolling window)
  • Доп. запросы: Не предусмотрены (превышение лимита приводит к ошибке 429 Too Many Requests)

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

Система считает запросы за последние 60 секунд:

  • Максимум 600 запросов в любом 60-секундном интервале
  • Если вы сделали 600 запросов между 12:00:00 и 12:00:59, новые запросы будут доступны с 12:01:00

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

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

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

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

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

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

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

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

Справочники

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

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

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

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

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

Извещения о закупках, контракты и планы закупок загружаются в течении следующего часа после публикации в ЕИС. Прочие документы (протоколы, разъяснения, процедуры и т.п.) загружаются с 03-00 до 09-00 МСК следующего дня.

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

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

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

Как загрузить документы из заданной подсистемы ЕИС?

За исключением контрактов по 44-ФЗ, каждая группа методов API соответствует одной подсистеме:

Тип подсистемы ЕИС Группа методов API
RPGZ fz44/tenderplans
PRIZ fz44/purchases
RPEC fz44/procedures
RGK, UR fz44/contracts
RPZ223 fz223/purchaseplans
RI223 fz223/purchases
RD223 fz223/contracts
PPRF615 pprf615/purchases
RD615 pprf615/contracts

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

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

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

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

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

Контакты

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