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

Быстрый старт — Python

Подготовка

Убедитесь, что установлен Python версии 3.x:

python3 --version

Дополнительные зависимости не требуются — используем встроенные модули urllib и json.

Пример запроса с API-ключом

import urllib.request
import json

API_KEY = "ВАШ_API_КЛЮЧ"

url = "https://v2.gosplan.info/fz44/purchases"
params = {
    "limit": 10,
    "skip": 0,
}

query_string = "&".join(f"{key}={value}" for key, value in params.items())
full_url = f"{url}?{query_string}"

request = urllib.request.Request(
    full_url,
    headers={"apikey": API_KEY},
)

try:
    with urllib.request.urlopen(request) as response:
        data = response.read().decode("utf-8")
        result = json.loads(data)
        print(json.dumps(result, indent=4, ensure_ascii=False))
except Exception as e:
    print(f"Произошла ошибка: {e}")

Как это работает

  1. Формирование URL — параметры limit и skip добавляются к базовому https://v2.gosplan.info/fz44/purchases.
  2. Авторизация — заголовок apikey передаёт ваш ключ в запросе.
  3. Обработка ответа — полученный JSON декодируется и выводится красиво.

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

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

Дополнительные детали по ошибкам — «Ошибки и их решение» и «API-ключ».

Что дальше