Код состояния HTTP 429 Too Many Requests ответ об ошибке клиента указывает на то, что клиент отправил слишком много запросов за определённый промежуток времени. Этот механизм, с помощью которого клиента просят снизить частоту запросов, обычно называют «ограничением частоты запросов».

В ответ может быть включён заголовок Retry-After, указывающий, сколько времени клиенту следует подождать, прежде чем повторить запрос.

Реализации ограничения частоты запросов различаются: ограничения могут распространяться на весь сервер или на отдельный ресурс. Обычно такие ограничения зависят от IP-адреса клиента, но могут применяться к конкретным пользователям или авторизованным приложениям, если запросы аутентифицированы или содержат файл cookie.

Статус

429 Too Many Requests

Примеры

Ответ с заголовком Retry-After

Клиент с неверной конфигурацией многократно отправляет следующий запрос в цикле:

GET /reports/mdn HTTP/1.1
Host: example.com

В этом примере ограничение частоты запросов на уровне всего сервера включается, когда клиент превышает заданный порог запросов в минуту. Возвращается ответ 429 с заголовком Retry-After, указывающим, что этому клиенту снова будет разрешено отправлять запросы через 3600 секунд (60 минут):

HTTP/1.1 429 Too Many Requests
Content-Type: text/html
Retry-After: 3600

<html lang="en-US">
  <head>
    <title>Too Many Requests</title>
  </head>
  <body>
    <h1>Too Many Requests</h1>
    <p>You're doing that too often! Try again later.</p>
  </body>
</html>

Спецификации

См. также

• Коды состояния ответа HTTP
• Retry-After
• Решение на Python: Как избежать ошибки HTTP 429 в Python