Syntax highlighting of Home
= Введение = == О проекте == Проект '''ГосПлан''' представляется собой набор сервисов, направленных на интеграцию с государственными закупками. Проект запущен в 2018м году. Базовыми публичными сервисами проекта '''ГосПлан''' являются веб-сервисы, которые предоставляют API к документам Единой информационной системе в сфере закупок (ЕИС Закупки, [[https://zakupki.gov.ru]]). Данный ресурс описывает вторую версию API, который запущен в 2025 году. Информация об API v1 приведена [[ v1 | здесь ]]. == Возможности API == Сервис предоставляет следующие данные: . по '''44-ФЗ''': планы-графики закупок, закупки (извещения, протоколы и др. документы), процедуры заключения контрактов, контракты. Начало загрузки документов - 01.01.2024. . по '''223-ФЗ''': планы закупок, закупки (извещения, протоколы и др. документы), договоры. Начало загрузки документов - 01.10.2024. . по '''ПП РФ 615''': закупки (извещения, протоколы и др. документы), контракты. Начало загрузки документов - 01.01.2025. Ориентировочный период хранения данных - '''3 года'''. == Архитектура сервиса == Сервис предоставляет JSON-данные по REST-протоколу и реализован на ''Python3'' с использованием [[https://fastapi.tiangolo.com/|FastAPI]]. API обеспечивает обработку входящих запросов с высокой производительностью и удобным документированием. Запросы обрабатываются синхронно, а выполнение сложных вычислений делегируется фоновым процессам. Для хранения данных используется [[https://www.mongodb.com/|MongoDB]], выступающая в роли основного хранилища. В базе данных содержатся как оперативные, так и исторические данные, а также метаданные для внутренней обработки. В качестве промежуточного хранилища для больших объемов данных, временных файлов и резервных копий используется [[https://aws.amazon.com/s3/|S3-совместимое хранилище]]. Оно применяется для обмена данными между сервисами, а также для хранения подготовленных файлов перед загрузкой в основную базу данных. Фоновая обработка данных, включая их загрузку, очистку и агрегацию, управляется системой [[https://airflow.apache.org/|Apache Airflow]], которая организует выполнение задач в виде DAG (Directed Acyclic Graph). Развертывание и обновление сервисов осуществляется с помощью [[https://argo-cd.readthedocs.io/|ArgoCD]], который отслеживает изменения в репозитории конфигураций и автоматически применяет их в [[https://kubernetes.io/|Kubernetes]]-кластере. Это позволяет реализовать GitOps-подход и обеспечить предсказуемость обновлений. Для обеспечения отказоустойчивости в случае инфраструктурных сбоев у основного провайдера сервис поддерживает Disaster Recovery (DR) окружение. DR-окружение развернуто в альтернативном дата-центре и синхронизируется с основной системой. При возникновении проблем с доступностью основной инфраструктуры выполняется автоматическое переключение на резервный контур с минимальным временем простоя. == Полезные ссылки == . вики - [[https://wiki.gosplan.info]] . описание API 44-ФЗ в формате swagger - [[https://swagger.gosplan.info/?urls.primaryName=44-ФЗ]] . описание API 223-ФЗ в формате swagger - [[https://swagger.gosplan.info/?urls.primaryName=223-ФЗ]] . описание API ПП РФ 615 в формате swagger - [[https://swagger.gosplan.info/?urls.primaryName=ППРФ-615]] = Начало работы = == Регистрация и аутентификация == В настоящее время регистрация и аутентификациия к ресурсу [[ https://v2.gosplan.info ]] не требуется. Доступ к API предоставляется на свободной основе до '''01.07.2025'''. После окончания бесплатного периода доступ будет осуществляться по '''API ключу''. {{{#!wiki note Информация о получении и использовании API ключа будет опубликована в ближайшее время. }}} == Инструкции == . [[ docs/howto-start | Получение доступа к API ]] . [[ docs/howto-xsd | Схемы документов ]] . [[ docs/howto-history | Исторические данные ]] == Документы == Обмен данными в ЕИС производится в формате XML с использованием протокола [[ https://en.wikipedia.org/wiki/AS2 | AS2 ]] ([[http://www.ietf.org/rfc/rfc4130.txt]]). Разделы информационной системы содержат различные XML-документы с различной структурой. Ниже приводится описание докумнетов, которые предоставляются через ГосПлан API. === Типы документов === . [[ docs/tenderplans | Планы-графики ]] . [[ docs/purchases | Закупки ]] . [[ docs/procedures | Процедуры заключения контрактов ]] . [[ docs/contracts | Контракты ]] === Справочники === Раздел содержит полезные справочные данные, которые используются в API . [[docs/regions-kladr | Коды регионов по КЛАДР]] . [[docs/okpd2 | ОКПД2 ]] . [[docs/ktru | КТРУ ]] . [[docs/nsiSpecialPurchases2020 | Типы особых закупок ]] == Правовые документы и реквизиты == . [[ legal/API-Usage-Agreement-v2 | Соглашение об использовании API ]] . [[ legal/requisites | Реквизиты ]] == Контакты == По всем вопросам работы сервисов '''ГосПлан API v2''' обращайтесь по контактным данным ниже: . почта - [[mailto:apiv2@gosplan.info | apiv2@gosplan.info]] . телеграмм - [[ https://t.me/gosplan_project ]]