Работа с API

Как программы получают данные из интернета — и как разобрать то, что пришло в ответ

API (Application Programming Interface) — это способ, которым одна программа просит данные у другой. Ты не лезешь в чужую базу данных — ты отправляешь запрос по определённому адресу и получаешь ответ в стандартном формате.

Аналогия: ты в ресторане. Не идёшь на кухню сам, а говоришь официанту «пиццу, пожалуйста». Он передаёт заказ повару и приносит результат. API — это официант. URL — это адрес ресторана (расположение кухни в ресторане). Параметры запроса — это заказ. JSON в ответе — это блюдо.

В Python для HTTP-запросов используют библиотеку requests. Она не встроена — нужно установить:

pip install requests

Простейший запрос — три строки:

import requests

response = requests.get("https://catfact.ninja/fact")
data = response.json()     # JSON -> словарь Python
print(data["fact"])        # текст факта

requests.get(url) отправляет GET-запрос по адресу и возвращает объект Response. У этого объекта есть метод .json(), который превращает текст ответа в обычный словарь Python. Дальше работаем со словарём как обычно — по ключам.

Большинство API принимают параметры — уточнения того, что именно ты хочешь. Параметры передаются через аргумент params:

import requests

url = "https://api.open-meteo.com/v1/forecast"
params = {
    "latitude": 55.75,
    "longitude": 37.62,
    "current": "temperature_2m,wind_speed_10m"
}

response = requests.get(url, params=params)
data = response.json()

Библиотека requests сама склеит URL и параметры в одну строку: url?latitude=55.75&longitude=37.62&current=.... Тебе не нужно делать это руками.

Кроме params у requests.get() есть аргумент headers — словарь с HTTP-заголовками. Некоторые API (например, Wikipedia) требуют заголовок User-Agent, иначе возвращают ошибку 403. Подробнее — в разделе 9.

Ответ API почти всегда приходит в формате JSON. Хорошая новость: ты уже знаешь JSON, потому что это тот же самый словарь Python — ключи, значения, вложенные структуры. Метод .json() превращает текст в настоящий словарь.

# JSON-текст, который пришёл от сервера:
{
    "current": {
        "temperature_2m": 12.5,
        "wind_speed_10m": 3.4
    }
}

# После response.json() это обычный словарь:
data["current"]["temperature_2m"]   # -> 12.5

Словарь может быть вложенным: внутри одного словаря лежит другой, внутри того — список, внутри списка — ещё словари. Чтобы добраться до нужного значения, нужно пройти по цепочке ключей.

Каждый ответ сервера содержит числовой код — status_code. По нему программа понимает, всё ли прошло успешно.

response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    print("Температура:", data["current"]["temperature_2m"])
else:
    print("Ошибка:", response.status_code)

Кроме кодов ответа есть ситуация хуже: сервер вообще не отвечает (нет интернета, сервер лежит, DNS не резолвится). В этом случае requests.get() бросит исключение. Чтобы программа не упала, оборачиваем в try/except:

try:
    response = requests.get(url, params=params, timeout=10)
    if response.status_code == 200:
        data = response.json()
        # работаем с данными
    else:
        print("Сервер вернул ошибку:", response.status_code)
except requests.RequestException:
    print("Нет связи с сервером")

Параметр timeout=10 — сколько секунд ждать ответа. Без него программа может зависнуть навсегда, если сервер не отвечает.

Ниже — ошибки, которые встречаются при запросах к API и разборе JSON. Запомни их — они будут в задачах и на контрольной.

Некоторые API возвращают не одиночные значения, а массивы (списки). Например, почасовой прогноз — это два параллельных списка по 24 элемента: время и температура.

# Запрос почасового прогноза
params = {
    "latitude": 55.75,
    "longitude": 37.62,
    "hourly": "temperature_2m"
}
data = requests.get(url, params=params).json()

temps = data["hourly"]["temperature_2m"]  # список из 24 чисел
times = data["hourly"]["time"]            # список из 24 строк

print("Максимум:", max(temps))
print("Минимум:", min(temps))
print("Среднее:", round(sum(temps) / len(temps), 1))

Массивы идут параллельно: температура с индексом 12 соответствует времени с индексом 12. Обходить их можно через range(len(...)) или через zip:

for time, temp in zip(times, temps):
    if temp >= 15:
        hour = time.split("T")[1]
        print(f"{hour} -- {temp}C")

Тебе показан JSON-ответ от API и вопрос: каким выражением достать нужное значение? Напиши путь, начиная с data.

Четыре сервиса, которые стабильно работают без регистрации и без ключа. Для каждого — URL, параметры, код и какие поля доставать.

url = "https://api.open-meteo.com/v1/forecast"
params = {
    "latitude": 55.75,          # Москва
    "longitude": 37.62,
    "current": "temperature_2m,wind_speed_10m,weather_code"
}
data = requests.get(url, params=params, timeout=10).json()

temp = data["current"]["temperature_2m"]       # 12.5
wind = data["current"]["wind_speed_10m"]      # 3.4
code = data["current"]["weather_code"]        # 0=ясно, 1-3=облачно, 61=дождь, 71=снег

Координаты других городов: Питер (59.93, 30.31), Казань (55.79, 49.12), Сочи (43.60, 39.73), Новосибирск (55.03, 82.92). Для почасового прогноза замените current на hourly — получите массив из 24 значений.

url = "https://www.cbr-xml-daily.ru/daily_json.js"
data = requests.get(url, timeout=10).json()

usd = data["Valute"]["USD"]["Value"]        # 92.5 (курс сегодня)
usd_prev = data["Valute"]["USD"]["Previous"] # 92.1 (курс вчера)
eur = data["Valute"]["EUR"]["Value"]        # 100.3

Параметров нет — URL фиксированный. Есть Value (сегодня) и Previous (вчера) — можно показать тренд: если Value > Previous, курс вырос.

url = "https://date.nager.at/api/v3/NextPublicHolidays/RU"
data = requests.get(url, timeout=10).json()   # это список!

if data:
    name = data[0]["localName"]   # "День труда"
    date = data[0]["date"]        # "2026-05-01"

Возвращает список, а не словарь — первый элемент это ближайший праздник. Обязательно if data: — список может быть пустым. Можно посчитать, сколько дней до праздника.

url = "https://catfact.ninja/fact"
data = requests.get(url, timeout=10).json()

fact = data["fact"]     # "Cats sleep 12-16 hours per day."

Параметров нет. Каждый запрос — новый случайный факт. Текст на английском. Самый простой API для первого подключения.

Эти API тоже работают, но с оговорками. Если хотите их использовать — будьте готовы к тому, что они могут быть временно недоступны.