Обработка ответов сервера с использованием библиотеки Requests

• 22.08.2023
• 193
• Библиотеки Python
• Requests

После отправки HTTP-запроса сервер возвращает ответ, содержащий различную информацию. Корректная обработка этих ответов критически важна при разработке надежных приложений. Давайте рассмотрим, как обрабатывать ответы с использованием библиотеки Requests.

Статус коды и их значения

При каждом ответе сервер возвращает код статуса, который показывает, был ли запрос успешным или возникли какие-то проблемы.

Основные классы статус-кодов:

• 2xx (Успешно): Запрос был успешно обработан. Например, 200 OK указывает на успешное выполнение GET-запроса.
• 3xx (Перенаправление): Запрос нуждается в дополнительных действиях для завершения. Например, 301 Moved Permanently указывает на постоянное перенаправление на другой URL.
• 4xx (Ошибка клиента): Произошла ошибка из-за действий клиента. Например, 404 Not Found означает, что ресурс не найден.
• 5xx (Ошибка сервера): Произошла ошибка на стороне сервера. Например, 500 Internal Server Error.

Проверка статус-кода с помощью Requests:

import requests

response = requests.get('https://api.example.com/items')

if response.status_code == 200:
    print('Успешный запрос!')
elif response.status_code == 404:
    print('Ресурс не найден.')
else:
    print(f'Произошла ошибка: {response.status_code}')

Извлечение контента ответа

После отправки HTTP-запроса и получения ответа от сервера одним из ключевых моментов является извлечение и обработка контента этого ответа. Requests предоставляет удобные методы и атрибуты для работы с различными типами контента.

Текстовый контент

Если сервер возвращает текстовый ответ, например, в формате HTML или XML, вы можете использовать атрибут text для его извлечения.

import requests

response = requests.get('https://www.example.com/')
print(response.text)  # выводит текстовое содержимое страницы

JSON

Для ответов в формате JSON, который часто используется в RESTful API, используйте метод json().

response = requests.get('https://api.example.com/data')
data = response.json()  # преобразует JSON-ответ в словарь или список Python
print(data['key'])      # обращение к конкретному ключу данных

Бинарные данные

Для бинарных ответов, например, изображений, файлов или других медиа-данных, используйте атрибут content.

response = requests.get('https://www.example.com/image.jpg')
with open('downloaded_image.jpg', 'wb') as file:
    file.write(response.content)  # сохраняет изображение на диск

Работа с потоковой передачей данных

Если вы загружаете большие объемы данных, такие как видео или большие файлы, вы можете использовать потоковую передачу данных.

response = requests.get('https://www.example.com/largefile.zip', stream=True)

with open('largefile.zip', 'wb') as file:
    for chunk in response.iter_content(chunk_size=8192):  # считывание данных по частям
        file.write(chunk)

Работа с заголовками ответа

Заголовки HTTP предоставляют дополнительную информацию о запросе или ответе, такую как тип содержимого, кодировка, кеширование и другие метаданные. Понимание и умение правильно работать с этими заголовками является ключевым навыком при работе с веб-запросами.

Получение заголовков ответа

Каждый ответ, который вы получаете с помощью библиотеки Requests, содержит заголовки, которые можно легко извлечь:

import requests

response = requests.get('https://www.example.com/')
headers = response.headers  # заголовки возвращаются как словарь

Теперь вы можете работать с headers как со словарем:

content_type = headers['Content-Type']
print(content_type)

Или, чтобы избежать ошибки KeyError в случае отсутствия заголовка:

content_type = headers.get('Content-Type')
if content_type:
    print(content_type)

Наиболее распространенные заголовки ответа

1. Content-Type: Тип содержимого. Например: text/html, application/json.
2. Content-Length: Размер содержимого ответа в байтах.
3. Date: Дата и время, когда ответ был отправлен.
4. Server: Название сервера, который обработал запрос.
5. Set-Cookie: Указывает на установку cookie.
6. Cache-Control: Управляет кешированием содержимого.
7. ETag: Идентификатор версии ресурса, который может быть использован для определения изменений в ресурсе.

Примеры работы с заголовками

Извлечение даты последнего изменения ресурса:

last_modified = headers.get('Last-Modified')
if last_modified:
    print(f"Ресурс был последний раз изменен: {last_modified}")

Проверка наличия кеширования:

cache_control = headers.get('Cache-Control')
if cache_control:
    print(f"Правила кеширования: {cache_control}")

Заключение

Обработка ответов — ключевой этап взаимодействия с веб-сервисами и API. Библиотека Requests предоставляет интуитивные инструменты для работы со статус-кодами, содержимым ответа и заголовками. Правильная обработка ответов позволяет разработчикам создавать устойчивые приложения, способные корректно взаимодействовать с различными веб-ресурсами.