Пропустить до содержимого
Документация

Быстрый старт — командная строка (curl)

Подготовка

Убедитесь, что в системе установлены:

Авторизация по API-ключу

Все примеры ниже построены вокруг https://v2.gosplan.info и используют заголовок apikey. До 01.08.2026 такой запрос может пройти и без ключа, но мы рекомендуем сразу добавлять API-ключ, чтобы после перехода не менять шаблоны.

curl -X GET -s \
  -H "apikey: $API_KEY" \
  "https://v2.gosplan.info/fz44/purchases?limit=1&skip=0"

Проверка доступности сервера

curl -X GET -s \
  "https://v2.gosplan.info" | jq

Запрос к корню https://v2.gosplan.info/ не требует API-ключа и позволяет проверить общую доступность сервиса. Для прямых обращений к методам с префиксами /fz44, /fz223 и /pprf615 обязательно включайте заголовок apikey.

Ожидаемый ответ содержит версию службы и ссылку на Swagger:

{
  "app version": "1.3.1",
  "API version": "v2.1.0",
  "API description": "https://swagger.gosplan.info"
}

Получение списка закупок

Найти самую «дорогую» закупку по 44-ФЗ:

curl -X GET -s \
  -H "apikey: $API_KEY" \
  "https://v2.gosplan.info/fz44/purchases?sort=max_price_desc&limit=1" \
  | jq '.[].max_price'

Типичные коды ответов

  • 200 OK — запрос выполнен успешно.
  • 401 Unauthorized — отсутствует или неверен API-ключ;
  • 403 Forbidden — API-ключ найден, но срок действия истёк или доступ ограничен.
  • 429 Too Many Requests — превышены лимиты для вашего тарифа (см. «Тарифы и лимиты»).
  • 5xx — внутренняя ошибка сервера; повторите позже.

Подробности про коды ответов и диагностику — в разделе «Ошибки и их решение» и «API-ключ».

Что дальше