Skip to content

Latest commit

 

History

History
62 lines (45 loc) · 2.48 KB

index.md

File metadata and controls

62 lines (45 loc) · 2.48 KB
title slug l10n
429 Too Many Requests
Web/HTTP/Status/429
sourceCommit
ba53fe04589c36a2210d7549c003f3016093ef8e

{{HTTPSidebar}}

HTTP の 429 Too Many Requests クライアントエラーレスポンスステータスコードは、クライアントが指定時間内にたくさんリクエストを送信しすぎたことを示します。 リクエストの速度を落とすようにクライアントに依頼するこの仕組みは、一般に「{{glossary("Rate limit", "速度制限")}}」と呼ばれています。

新しいリクエストを行う前にどのくらい待つかを示す {{HTTPHeader("Retry-After")}} ヘッダーをこのレスポンスに含めることができます。

速度制限の実装は様々で、制限はサーバー全体かもしれませんし、リソース毎かもしれません。 通常、速度制限の制限はクライアントの IP に基づいて行われますが、 リクエストが認証されていたり {{Glossary("Cookie", "クッキー")}} が含まれていたりしていれば、 ユーザーや許可されたアプリケーションに固有の制限をかける可能性もあります。

ステータス

429 Too Many Requests

例

Retry-After ヘッダーを含んだレスポンス

以下のリクエストが、設定ミスのあるクライアントによって繰り返しループして送信されているとします。

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

この例では、クライアントが 1 分あたりのリクエスト数が設定したしきい値を超えたときに、サーバ全体の速度制限が有効になります。 リクエストは 60 分後にこのクライアントに再び許可されることを示す {{HTTPHeader("Retry-After")}} ヘッダーとともに 429 レスポンスを返します。

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>

仕様書

{{Specifications}}

関連情報