このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
429 Too Many Requests
HTTP の 429 Too Many Requests はクライアントエラーレスポンスステータスコードで、クライアントが指定時間内にたくさんリクエストを送信しすぎたことを示します。
リクエストの速度を落とすようにクライアントに依頼するこの仕組みは、一般に「速度制限」と呼ばれています。
新しいリクエストを行う前にどのくらい待つかを示す Retry-After ヘッダーをこのレスポンスに含めることができます。
速度制限の実装は様々で、制限はサーバー全体かもしれませんし、リソース毎かもしれません。 通常、速度制限はクライアントの IP アドレスに基づいて行われますが、リクエストが認証されている場合やクッキーが含まれている場合は、ユーザーや許可されたアプリケーションに特定して制限することもあります。
ステータス
http
429 Too Many Requests
例
Retry-After ヘッダーを含んだレスポンス
以下のリクエストが、設定ミスのあるクライアントによって繰り返しループして送信されているとします。
http
GET /reports/mdn HTTP/1.1
Host: example.com
この例では、クライアントが 1 分あたりのリクエスト数が設定したしきい値を超えたときに、サーバー全体の速度制限が有効になります。
リクエストは 60 分後にこのクライアントに再び許可されることを示す Retry-After ヘッダーとともに 429 レスポンスを返します。
http
HTTP/1.1 429 Too Many Requests
Content-Type: text/html
Retry-After: 3600
<html>
<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>
仕様書
| 仕様書 |
|---|
| RFC 6585 # section-4 |
関連情報
- HTTP レスポンスステータスコード
Retry-After- Python での解決策: How to avoid HTTP error 429 python