Разбираемся
JSON — текстовый формат передачи структурированных данных. Внешне он похож на словари и списки Python.
{
"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:
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 — список, внутри которого находятся словари. Пример упрощённого фрагмента структуры:
types = [
{'slot': 1, 'type': {'name': 'electric'}},
]
print(types[0]['type']['name'])
Здесь сначала выбираем элемент списка, затем словарь type, а потом поле name.
Если поле может отсутствовать, полезен метод словаря .get():
book = {'title': 'Пример книги'}
print(book.get('year', 'Год неизвестен'))
Важно: response.text возвращает текст, а response.json() пытается разобрать его как JSON. Не каждый ответ сервера содержит JSON.
Попробуй
- В примере с PokéAPI выведи ещё значение поля
height. - Посмотри на структуру
data['types']. Определи, где список, а где словари. - Выведи названия всех типов покемона. Проверь программу для номера
25и для номера1. - Вопрос: зачем иногда удобнее писать
book.get('year'), а неbook['year']?