Syntax highlighting of Home

= ГосПлан =

== О проекте ==

Проект '''ГосПлан''' представляется собой набор сервисов, направленных на интеграцию с государственными закупками. Проект запущен в 2018м году.

Базовыми публичными сервисами проекта '''ГосПлан''' являются веб-сервисы, которые предоставляют API к документам Единой информационной системе в сфере закупок (ЕИС Закупки, [[https://zakupki.gov.ru]]). Актуальная версия версия  - '''ГосПлан API v1''':
 . сайт проекта - [[https://dev.gosplan.info/]],
 . документация - [[https://quarter18.gitbook.io/gosplan/]],
 . описание API - [[https://api-doc.gosplan.info/]]

В настоящее время ведется разработка второй версии API - '''ГосПлан API v2''':
 . документация - [[https://wiki.gosplan.info]]
 . описание API - [[https://swagger-v2beta.gosplan.info]]

Вторая версия '''обратно не совместима''' с первой.

Эта вики содержит материалы касательно новой версии 2.


== ГосПлан API v2 ==

Настоящее время вторая версия проекта '''ГосПлан API''' находится в разработке. Были учтены особенности функционирования первой версии, а также современные тендеции развития web-приложений. Помимо очевидных изменений в методах доступа к ресурсам пересмотрены стек инструментов разработки, доставки и развертывания сервисов. По сути проект переписывается ''с нуля''.

Главной особенностью новой версии является явное ограничение во времени харенения документов. В первой версии Сервиса хранение документов является ''накопительным'', т.е. обозначалась дата, начиная с которой все документы,  опубликовынные в ЕИС, попадают в сервис. Со временем объем хранимых документов возрастает на столько, что поиск по ним занимает неприлично много времени. Исходя из вариантов использования сервиса, значительное количество запросов относится к актуальным (открытым) закупкам и контрактам, тогда как ''исторические данные'' не пользуются популярностью. В новой версии API доступ будет предоставляться к ''актуальным'' документам. Это означает, что сервис гарантировано сохраняет информацию о закупках, процедурах и контрактах до тех пор, пока закупка или контракт не закрыты. После того, как документы потеряли '''актуальность''', они могут еще храниться какое-то время. Возможно это время будет определяться неким фиксированным значением или определяться динамечески. Главное, что хранение '''неактуальных''' документов не гарантируюется.

Если Вам требуются ''исторические данные'', то можно ознакомиться с [[ docs/howto-history | этой ]] страничкой в разделе документации.

Основные отличия версий:
||  || v1 || v2 ||
=======================
|| ''Хранение документов'' || Накопительное  || Актуальные данные  ||
|| Метод авторизации || JWT || API Key ||
|| ''API процедур заключения контрактов'' || Отсутствуют || Планируются ||
|| ''Закупки по ПП РФ 615'' || В группе API 44-ФЗ  || Вынесены в отдельный API  ||
|| TODO || || ||

== План развития ==

Запуск сервисов предполагается поэтапно и каждый этап будет иметь собственный домен. Например, первоначально доступ к API будет осуществляться по адресу [[ v2beta.gosplan.info ]]. API следующего этапа будет доступно по адресу [[ v2pre1.gosplan.info ]], потом [[ v2pre2.gosplan.info ]] и т.д. При этом парные домены (v2beta и v2pre1 или v2pre1 и v2pre2) будут доступны одновременно. Одновременный доступ к API разных этапов предполагается с целью обеспечить ''мягкий'' переход между версиями API в процессе развития.

Ниже приводится ориентировочный план внедрения сервисов '''ГосПлан API v2''':


|| Этап || Адрес сервиса || Описание || Срок ||
====================================
|| Beta || [[https://v2beta.gosplan.info]] || Документы по 44-ФЗ || 12.2023
|| Pre1 || [[https://v2pre.gosplan.info]] || Документы по ПП РФ 615 || 
|| Pre2 || [[https://v2pre.gosplan.info]] || Документы по 223 - ФЗ ||
|| v2 || [[https://v2pre.gosplan.info]] || Авторизация, веб-хуки ||

== Материалы проекта ==

 . [[ docs | Документация ]]
 . [[ refs | Справочники ]]
 . [[ legal | Правовые документы и реквизиты ]]

== Контакты ==

По всем вопросам работы сервисов '''ГосПлан API v2''' обращайтесь по контактным данным ниже:
 . [[mailto:apiv2@gosplan.info | apiv2@gosplan.info]]