Обработка кодов состояния HTTP в requests: руководство с примерами

Расширенные примеры работы с кодами ответов HTTP

Пример 1: Обработка ошибок с raise_for_status и кастомное исключение

import requests
from requests.exceptions import HTTPError

def safe_get(url):
    try:
        resp = requests.get(url, timeout=5)
        resp.raise_for_status()
        return resp.json()
    except HTTPError as e:
        print(f'HTTP ошибка: {e.response.status_code} - {e.response.reason}')
        if e.response.status_code == 404:
            print('Ресурс не найден, возвращаем пустой словарь')
            return {}
        raise
    except requests.exceptions.RequestException as e:
        print(f'Ошибка подключения: {e}')
        return None

data = safe_get('https://httpbin.org/status/404')
print(f'Данные: {data}')

HTTP ошибка: 404 - Not Found
Ресурс не найден, возвращаем пустой словарь
Данные: {}

В этом примере перехватывается HTTPError, для 404 возвращается пустой словарь вместо исключения. Другие ошибки пробрасываются дальше. Также обрабатываются общие ошибки подключения.

Пример 2: Проверка кода ответа и парсинг JSON с разными результатами

import requests

resp = requests.get('https://httpbin.org/uuid')
if resp.status_code == 200:
    uuid_data = resp.json()
    print(f'UUID: {uuid_data["uuid"]}')
elif resp.status_code == 429:
    print('Слишком много запросов. Подождите.')
else:
    print(f'Необработанный код: {resp.status_code}')

UUID: 123e4567-e89b-12d3-a456-426614174000

Код реагирует на разные коды: при 200 - парсинг и использование данных, при 429 - сообщение о лимите, иначе - просто вывод кода.

Пример 3: Использование статус-кодов для проверки наличия ресурса (HEAD-запрос)

import requests

def resource_exists(url):
    try:
        resp = requests.head(url, allow_redirects=True)
        return resp.status_code == 200
    except requests.exceptions.RequestException:
        return False

check = resource_exists('https://httpbin.org/get')
print(f'Существует: {check}')

Существует: True

HEAD-запрос не загружает тело ответа, только заголовки. Код 200 указывает на существование ресурса. allow_redirects=True позволяет следовать редиректам.

Пример 4: Имитация разных кодов с помощью httpbin и тестирование логики

import requests

test_urls = [
    'https://httpbin.org/status/200',
    'https://httpbin.org/status/201',
    'https://httpbin.org/status/400',
    'https://httpbin.org/status/500',
    'https://httpbin.org/status/302'
]

for url in test_urls:
    resp = requests.get(url, allow_redirects=False) # отключаем авторедирект
    print(f'URL: {url} -> Код: {resp.status_code}, ok: {resp.ok}, причина: {resp.reason}')

URL: https://httpbin.org/status/200 -> Код: 200, ok: True, причина: OK
URL: https://httpbin.org/status/201 -> Код: 201, ok: True, причина: Created
URL: https://httpbin.org/status/400 -> Код: 400, ok: False, причина: Bad Request
URL: https://httpbin.org/status/500 -> Код: 500, ok: False, причина: Internal Server Error
URL: https://httpbin.org/status/302 -> Код: 302, ok: False, причина: Found

Обратите внимание: при отключённом авторедиректе код 302 считается неуспешным. Если бы редиректы были включены, requests автоматически перешёл бы по Location и вернул конечный код (обычно 200).

Пример 5: Обработка кода 304 Not Modified с использованием ETag

import requests

url = 'https://httpbin.org/etag/test'
# Первый запрос - получаем ETag
resp1 = requests.get(url)
etag = resp1.headers.get('ETag')
print(f'Первый ответ: {resp1.status_code}, ETag: {etag}')
# Второй запрос с If-None-Match
headers = {'If-None-Match': etag}
resp2 = requests.get(url, headers=headers)
print(f'Второй ответ: {resp2.status_code}')  # Должно быть 304
if resp2.status_code == 304:
    print('Данные не изменились, используем кеш')

Первый ответ: 200, ETag: 'test'
Второй ответ: 304
Данные не изменились, используем кеш

Код 304 означает, что ресурс не изменился, и сервер не передаёт тело. Это полезно для кеширования.

Пример 6: Кастомный обработчик с проверкой на несколько кодов успеха

import requests

SUCCESS_CODES = {200, 201, 202, 204}

def process_response(resp):
    if resp.status_code in SUCCESS_CODES:
        print(f'Успешный код: {resp.status_code}')
        if resp.status_code == 204:
            return None
        return resp.json()
    else:
        print(f'Ошибка {resp.status_code}: {resp.text}')
        return None

resp = requests.get('https://httpbin.org/status/202')
data = process_response(resp)
print(f'Полученные данные: {data}')

Успешный код: 202
Полученные данные: None (так как httpbin вернул пустое тело, но код 202)

Здесь определён набор кодов, которые считаются успешными. Для 204 (No Content) возвращается None. Для остальных - пытаемся распарсить JSON.