エラー 429

429 Too Many Requests

429 Too Many Requests ステータスコードは、サーバーのレート制限ルールで定めた時間内に、クライアントがリクエストを送りすぎたことを示します。サーバーは、クライアントが再試行できる時期を示す Retry-After ヘッダーをレスポンスに付けることがあります。

詳細は RFC 6585 ↗ を参照してください。

一般的な用途

サーバーはこのステータスコードを使い、過剰な API リクエストによるシステムの過負荷を防ぎます。たとえば、短時間に API 呼び出しを繰り返すクライアントは、429 レスポンスを引き起こすことがあります。ウェブサイトやサービスは、トラフィックの急増や不正利用を抑えるためにレート制限をかけ、過剰なリクエストを一時的に遮断することがあります。

Cloudflare 固有の情報

Cloudflare API の制限

種類	上限
ユーザー / アカウントトークンごとの Client API	5 分あたり 1,200
IP ごとの Client API	毎秒 200
GraphQL	クエリコストにより異なる。最大は 5 分あたり 320
ユーザー API トークンのクォータ	50
アカウント API トークンのクォータ	500

一部の API 呼び出しには独自の上限があり、次のように別途記載されています。

Enterprise のお客様は、Cloudflare サポートに問い合わせて、ユーザーごとの Client API、GraphQL、または API トークンの上限を引き上げることもできます。

R2 のマネージド公開バケット

Cloudflare は、r2.dev 経由でアクセスする R2 のマネージド公開バケットへのリクエストにレート制限を適用します。公開バケットの不正利用や過剰利用から顧客を守るためです。詳細は Rate limiting on managed public buckets through r2.dev を参照してください。

ウェブサイトのエンドユーザー

リクエストがレート制限 ↗されている場合、Cloudflare は 429 レスポンスを生成します。サイト訪問者がこのエラーに遭遇すると、Rate Limiting Analytics ダッシュボードに表示されます。