← Все темыШаг 8 из 11

Учимся читать документацию нового API

Разбираемся

У каждого API собственные адреса, параметры и формат ответа. Поэтому программист сначала знакомится с документацией.

Полезно найти ответы на вопросы:

  1. Куда отправлять запрос?
  2. Какой метод нужен?
  3. Какие параметры обязательные, а какие дополнительные?
  4. Где в JSON лежат нужные данные?
  5. Какие возможны ошибки и ограничения?

Рассмотрим другой сервис — Open-Meteo. Он умеет возвращать погодные показатели по координатам. Для знакомства с форматом ответа запросим только температуру для заранее известных координат:

python
import requests

url = 'https://api.open-meteo.com/v1/forecast'
params = {
    'latitude': 52.52,
    'longitude': 13.41,
    'current': 'temperature_2m',
}

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

print(data['current']['temperature_2m'])

Координаты относятся к Берлину. Единицу измерения можно найти в поле current_units ответа.

Документация для самостоятельного изучения:

Небольшое исследование

  1. Найди в ответе Open-Meteo поле с единицей измерения температуры и выведи температуру вместе с единицей.
  2. По документации узнай, как запросить текущую относительную влажность. Добавь её в запрос и выведи новое значение.
  3. Вопрос: почему нельзя просто копировать адрес и названия полей из одного API в другой?

Это не готовый «Погодный информатор», а знакомство с документацией и устройством нового сервиса.