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

Смотри, вот тебе про эти ваши HTTP-статусы, без всякой академической пыли. Представь, что ты официант в ресторане, а браузер или приложение — это клиент, который заказывает еду. Статус-код — это твой ответ клиенту, понятно? Ты либо киваешь, либо пожимаешь плечами, либо посылаешь его на три буквы. Всё просто, ёпта.

Эти цифры, они по группам живут:

• 1xx (Информационные): Ты такой: «Слышь, заказ принял, ща повару передам, не дёргайся». Клиент ждёт дальше.
• 2xx (Успех): Всё заебись. Принёс клиенту то, что он просил.
  • 200 OK: Стандартный «держи, на, жри». Заказ выполнен.
  • 201 Created: Ты не только принёс, ты ещё и блюдо по рецепту клиента на кухне состряпал. «Вот ваш личный бургер, сэр».
  • 204 No Content: Клиент попросил убрать со стола, ты убрал, кивнул и ушёл. Ничего в руках не нёс, но работа сделана.
• 3xx (Перенаправление): Ты такой: «Братан, тот стол, за которым ты сидишь — говно. Иди нахуй вон к тому окну, там лучше».
  • 301 Moved Permanently: «Мы этот столик вообще в другой зал перенесли, навсегда. Запоминай новый путь».
  • 302 Found: «Ой, тут муха в супе, иди временно посиди там».
  • 304 Not Modified: Клиент спрашивает: «А суп тот же самый, что я вчера ел?». Ты такой: «Да тот же, блядь, хоть с закрытыми глазами ешь».
• 4xx (Ошибка клиента): Это когда клиент — мудак. Прости, но это так.
  • 400 Bad Request: «Ты мне на салфетке какую-то хуйню нарисовал вместо заказа. Я нихуя не понял».
  • 401 Unauthorized: «А ты кто такой? Покажи клубную карту или вали нахуй».
  • 403 Forbidden: «Карту вижу. Но в VIP-лаунж тебе с твоей картой низя. Пошёл вон».
  • 404 Not Found: Классика! «Ты просил суп „Лапша астральная“. У нас такого нет и не было. Иди нахуй».
  • 409 Conflict: «Ты пытаешься заказать столик №5, но там уже твоя же баба сидит с другим мужиком. Конфликт, сука».
• `5xx (Ошибка сервера):** А вот это уже наш косяк, пиздец. Кухня горит.
  • 500 Internal Server Error: «Шеф-повар с похмелья и забыл, как яйцо пожарить. Внутренняя ошибка кухни».
  • 502 Bad Gateway: «Я сходил к поставщику за мясом, а он мне говна какого-то подсунул. Не могу тебе нормальный заказ принести».
  • 503 Service Unavailable: «Всё, кухня закрыта, все повара свалили. Заходите завтра, если не сгорним».

Как с этим в Python`е работать (со стороны клиента)?

Берёшь библиотеку 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'Сервер наехал! Код: {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}')

Зачем так? Чтобы твоя программа не падала молча, как подкошенная, а понимала, что пошло не так, и могла с этим что-то сделать.

А если ты сам сервер делаешь (на 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 не гадали на кофейной гуще, а чётко знали: окей, создалось; ой, я дурак; ой, у них там пожар.

Итог, блядь: Без этих статусов в интернете был бы полный пиздец и неразбериха. Это как правила дорожного движения для данных. Светофор, ёбаный. Красный — стой, зелёный — иди, а 404 — это знак «тупик», поставленный посреди оживлённой трассы.