При каких HTTP-статусах можно повторять запрос?

Повторять HTTP-запросы безопасно и эффективно при возникновении временных (транзиентных) ошибок, которые указывают на проблемы на стороне сервера или временные сетевые неполадки. Важно учитывать идемпотентность запроса: повторение идемпотентного запроса (например, GET, PUT, DELETE) не должно приводить к нежелательным побочным эффектам.

HTTP-статусы, при которых можно повторять запрос:

• 5xx (Server Errors): Эти ошибки указывают на проблемы на стороне сервера, которые часто бывают временными. Повторный запрос через некоторое время может быть успешным.

  • 500 Internal Server Error: Общая ошибка сервера.
  • 502 Bad Gateway: Сервер, выступающий в роли шлюза, получил недействительный ответ.
  • 503 Service Unavailable: Сервер временно не может обрабатывать запрос (например, перегружен или на обслуживании). Часто сопровождается заголовком Retry-After.
  • 504 Gateway Timeout: Сервер, выступающий в роли шлюза, не получил ответ вовремя.

• Некоторые 4xx (Client Errors): В редких случаях клиентские ошибки также могут быть временными.

  • 408 Request Timeout: Сервер не получил полный запрос от клиента в течение времени, которое он был готов ждать.
  • 429 Too Many Requests: Клиент отправил слишком много запросов за определенный период. Сервер может указать время ожидания в заголовке Retry-After.

Пример реализации повторных попыток с экспоненциальной задержкой (Exponential Backoff) на Python:

import requests
import time
from requests.exceptions import RequestException

def make_retriable_request(url: str, max_retries: int = 5, initial_delay: float = 0.1):
    """
    Выполняет HTTP GET запрос с повторными попытками при временных ошибках.
    Использует экспоненциальную задержку между попытками.
    """
    for attempt in range(max_retries):
        try:
            response = requests.get(url)
            # Успешные ответы или клиентские ошибки, которые не следует повторять
            if 200 <= response.status_code < 500 and response.status_code not in [408, 429]:
                return response

            # Обработка 429 с учетом Retry-After
            if response.status_code == 429 and 'Retry-After' in response.headers:
                delay = int(response.headers['Retry-After'])
                print(f"Получен 429, ожидание {delay} секунд перед повтором.")
                time.sleep(delay)
                continue # Сразу следующая попытка после ожидания

            # Для 5xx и 408/429 без Retry-After - используем экспоненциальную задержку
            print(f"Попытка {attempt + 1}/{max_retries}: Получен статус {response.status_code}. Повтор через задержку.")

        except RequestException as e:
            # Обработка сетевых ошибок (например, ConnectionError, Timeout)
            print(f"Попытка {attempt + 1}/{max_retries}: Сетевая ошибка: {e}. Повтор через задержку.")

        if attempt < max_retries - 1:
            delay = initial_delay * (2 ** attempt) # Экспоненциальная задержка
            time.sleep(delay)

    print(f"Все {max_retries} попыток исчерпаны. Запрос не выполнен.")
    return None

# Пример использования:
# response = make_retriable_request("http://example.com/api/data")
# if response:
#     print(f"Успешный ответ: {response.status_code}")

HTTP-статусы, при которых НЕ следует повторять запрос без изменений на стороне клиента:

• 400 Bad Request: Запрос клиента сформирован некорректно.
• 401 Unauthorized: Требуется аутентификация.
• 403 Forbidden: Доступ к ресурсу запрещен.
• 404 Not Found: Запрашиваемый ресурс не существует.
• 405 Method Not Allowed: Метод запроса не поддерживается для данного ресурса.
• 409 Conflict: Конфликт состояния ресурса (например, попытка создать уже существующий ресурс).

Повторение этих запросов без исправления исходной проблемы на стороне клиента бесполезно и может привести к ненужной нагрузке на сервер.