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

JSON: превращаем ответ в данные Python

Разбираемся

JSON — текстовый формат передачи структурированных данных. Внешне он похож на словари и списки Python.

json
{
  "name": "Пример",
  "level": 3,
  "available": true,
  "tags": ["один", "два"],
  "comment": null
}

Этот JSON вымышленный — он нужен, чтобы рассмотреть формат.

JSON Что получится в Python
Объект {...} Словарь dict
Массив [...] Список list
true / false True / False
null None
Строка str
Число int или float

Библиотека requests умеет прочитать JSON-ответ и преобразовать его в структуры Python:

python
import requests

response = requests.get(
    'https://pokeapi.co/api/v2/pokemon/25',
    timeout=10,
)
response.raise_for_status()
data = response.json()

print(data['name'])
print(data['id'])
  • raise_for_status() вызывает исключение, если пришёл статус ошибки 4xx или 5xx.
  • json() преобразует тело JSON в словари, списки и другие значения Python.

В ответах встречаются вложенные списки и словари. Например, у PokéAPI поле types — список, внутри которого находятся словари. Пример упрощённого фрагмента структуры:

python
types = [
    {'slot': 1, 'type': {'name': 'electric'}},
]

print(types[0]['type']['name'])

Здесь сначала выбираем элемент списка, затем словарь type, а потом поле name.

Если поле может отсутствовать, полезен метод словаря .get():

python
book = {'title': 'Пример книги'}
print(book.get('year', 'Год неизвестен'))

Важно: response.text возвращает текст, а response.json() пытается разобрать его как JSON. Не каждый ответ сервера содержит JSON.

Попробуй

  1. В примере с PokéAPI выведи ещё значение поля height.
  2. Посмотри на структуру data['types']. Определи, где список, а где словари.
  3. Выведи названия всех типов покемона. Проверь программу для номера 25 и для номера 1.
  4. Вопрос: зачем иногда удобнее писать book.get('year'), а не book['year']?