Документация ГосПлан API

ГосПлан — инфраструктура данных о закупках ЕИС. Модуль ГосПлан API предоставляет понятную документацию, которая объединяет быстрый старт, технические справочники и практические рекомендации по ошибкам.

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

1. Начните с обзора /docs/getting-started/overview — здесь рассказывается о структурах данных и периодах хранения.
2. Настройте запросы через один из quickstart-руководств:
   • curl: /docs/getting-started/quickstart-curl
   • Python: /docs/getting-started/quickstart-python
   • Swagger UI: /docs/getting-started/quickstart-swagger
3. Ознакомьтесь со справочниками для кодов и типов документов в разделе /docs/dictionaries.

Пример

Пример запроса на список закупок по 44-ФЗ можно найти в /docs/guides/purchases. Там описаны параметры фильтрации, пагинация и пример ответа.

Пояснение

• В разделе guides размещены практические инструкции:
  • howto-xsd описывает схемы XML и поясняет, как валидировать документы.
  • history-data объясняет, как работать с архивом трех лет данных.
• Справочники содержат соответствие кодов и типов документов (44-ФЗ, 223-ФЗ, ПП РФ 615, регионы, ОКПД2, КТРУ).
• FAQ и troubleshooting содержат ответы на типовые вопросы и рекомендации по обработке ошибок.

Возможные ошибки

• 401 Unauthorized — проверьте API-ключ и заголовок Authorization.
• 429 Too Many Requests — соблюдайте лимиты тарифа (подробнее /pricing).
• 404 Not Found — убедитесь, что идентификатор документа корректен и попадает в период хранения.
• Бизнес-ошибки с кодом 422 описаны в /docs/errors/troubleshooting.

Связанные материалы

• /pricing — тарифы и ограничения по запросам.
• /api — обзор API и ссылки на Swagger-сценарии.
• /roadmap — публичная дорожная карта gosplan-v2.