Каково назначение HTTP статус-кодов и как их обрабатывать в Python?

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

Основные группы HTTP статус-кодов:

• 1xx (Информационные): Запрос принят, обработка продолжается. (Например, 100 Continue).
• 2xx (Успех): Запрос успешно обработан.
  • 200 OK: Стандартный успешный ответ.
  • 201 Created: Ресурс успешно создан (например, после POST-запроса).
  • 204 No Content: Запрос успешно обработан, но ответ не содержит тела.
• 3xx (Перенаправление): Для завершения запроса требуются дополнительные действия.
  • 301 Moved Permanently: Ресурс перемещен навсегда.
  • 302 Found: Ресурс временно перемещен.
  • 304 Not Modified: Ресурс не изменился с момента последнего запроса.
• 4xx (Ошибка клиента): Запрос содержит синтаксическую ошибку или не может быть выполнен.
  • 400 Bad Request: Некорректный запрос.
  • 401 Unauthorized: Требуется аутентификация.
  • 403 Forbidden: Доступ запрещен.
  • 404 Not Found: Ресурс не найден.
  • 409 Conflict: Конфликт при обработке запроса (например, попытка создать уже существующий ресурс).
• 5xx (Ошибка сервера): Сервер не смог выполнить запрос.
  • 500 Internal Server Error: Общая ошибка сервера.
  • 502 Bad Gateway: Сервер, выступающий в роли шлюза, получил недействительный ответ от вышестоящего сервера.
  • 503 Service Unavailable: Сервер временно не может обрабатывать запросы (например, из-за перегрузки или обслуживания).

Обработка HTTP статус-кодов в Python:

В Python для работы с HTTP-кодами чаще всего используются библиотека requests для клиентских запросов и веб-фреймворки (Flask, FastAPI, Django) для серверной части.

Пример обработки ответа клиента (requests):

import requests

try:
    response = requests.get('https://api.example.com/data')
    response.raise_for_status() # Вызывает исключение для статусов 4xx/5xx

    print(f'Успешный запрос! Статус: {response.status_code}')
    print(f'Данные: {response.json()}')

except requests.exceptions.HTTPError as e:
    print(f'Ошибка HTTP: {e.response.status_code} - {e.response.reason}')
    if e.response.status_code == 404:
        print('Ресурс не найден.')
    elif e.response.status_code == 401:
        print('Требуется аутентификация.')
except requests.exceptions.ConnectionError as e:
    print(f'Ошибка соединения: {e}')
except requests.exceptions.Timeout as e:
    print(f'Таймаут запроса: {e}')
except requests.exceptions.RequestException as e:
    print(f'Общая ошибка запроса: {e}')

Почему: Использование response.raise_for_status() и обработка исключений requests является best practice для надежной обработки ошибок HTTP.

Пример возврата статуса в веб-фреймворке (Flask):

from flask import Flask, jsonify, request, abort

app = Flask(__name__)

@app.route('/items', methods=['GET'])
def get_items():
    # Пример возврата 200 OK
    return jsonify([{"id": 1, "name": "Item A"}, {"id": 2, "name": "Item B"}]), 200

@app.route('/items', methods=['POST'])
def create_item():
    if not request.json or 'name' not in request.json:
        # Возврат 400 Bad Request
        abort(400, description="Необходимо указать 'name' для нового элемента.")
    # Пример возврата 201 Created
    new_item = {"id": 3, "name": request.json['name']}
    return jsonify(new_item), 201

@app.route('/items/<int:item_id>', methods=['GET'])
def get_item(item_id):
    if item_id == 404:
        # Пример возврата 404 Not Found
        abort(404, description=f"Элемент с ID {item_id} не найден.")
    # ... логика получения элемента ...
    return jsonify({"id": item_id, "name": f"Item {item_id}"}), 200

if __name__ == '__main__':
    app.run(debug=True)

Почему: Правильное использование статус-кодов в API помогает клиентам корректно интерпретировать ответы сервера и упрощает интеграцию.

Важность: Корректная обработка и возврат HTTP статус-кодов критически важны для создания надежных, понятных и удобных в использовании API и клиентских приложений.