EASYBOT GUIDE

429 Too Many Requestsの原因とAPIレート制限の対処法

HTTP 429が返る理由、Retry-Afterの読み方、Discordや外部APIのレート制限を守る再試行方法を紹介します。

2026年9月18日更新

429 Too Many Requestsは、短い時間に送った要求がサービスの上限を超えた時に返るHTTPステータスです。要求を連続再送すると制限が長引くため、応答の指示に従って待つ必要があります。

まずRetry-Afterを確認

応答にRetry-Afterがあれば、その秒数または日時まで待ってから再試行します。APIごとに上限は異なり、DiscordではルートやBot単位の制限があるため、固定間隔だけの処理では不十分です。

一斉に同じ要求を再送すると、復旧直後に再び制限へ達します。指数バックオフとランダムな待ち時間を使い、再試行回数にも上限を設けます。

イベントごとに大量のメッセージを送る、失敗したログインを高速で繰り返す、スラッシュコマンドを全件更新する処理が原因になります。バッチ化やキューを使い、不要な要求を減らします。

429の回数、APIルート、待機時間を記録し、急増を検知します。制限回避のためアカウントやIPを切り替える行為はサービス規約違反や停止につながるため行いません。