429 要求が多すぎます: その意味と対処方法

API は、アプリが一定期間内に API が許可するリクエスト数を超えて要求を送信したときに、429 Too Many Requests を返します。 要求自体は問題ありません。 送信頻度が高すぎるため、API によって拒否されました。 待機してもう一度送信すると、通常は成功します。 応答には、多くの場合、待機する時間を示す Retry-After ヘッダーが含まれています。 詳細については、 RFC 6585、セクション 4 を参照してください。

一般的な API での 429 エラーの表示例

各 API では、レート制限が異なる方法で実装されます。 状態コード、ヘッダー、およびエラー本文はすべて異なるため、1 つの API を正しく処理するコードが次の API を誤って処理する可能性があります。

429 を処理する方法

1. 再試行するかどうかを決定します。 クォータ、クレジット、または利用上限が使い切れているというエラーが表示された場合、再試行しても役に立ちません。 ユーザーに通知し、自分自身に警告します。
2. API が要求する限り待ちます。 応答に Retry-After が含まれている場合は、その時間だけ待機します。 秒数または HTTP 日付のいずれかです。 GITHUBのx-ratelimit-resetのように、API がレート制限ヘッダーを代わりに使用する場合は、リセット時刻まで待ちます。
3. それ以外の場合は、バックオフ。 API からのヒントなしで、指数バックオフとランダム ジッターを使用して再試行し、数回試行した後に停止します。
4. ユーザーに何が起こっているのかを伝えます。 「ビジー状態です。5 秒後に再試行します」は、決して終了しないスピナーよりも良いです。
5. 次の 429 エラーの前に速度を落としてください。 API がレート制限ヘッダーを送信する場合は、残りのカウントを使用して要求のペースを設定します。

async function fetchWithRetry(url, options, attempts = 3) {
  for (let attempt = 1; ; attempt++) {
    const response = await fetch(url, options);
    if (response.status !== 429 || attempt === attempts) {
      return response;
    }
    const retryAfter = response.headers.get('retry-after');
    const waitMs = retryAfter
      ? (isNaN(retryAfter) ? new Date(retryAfter) - Date.now() : retryAfter * 1000)
      : 2 ** attempt * 1000 + Math.random() * 1000;
    await new Promise(resolve => setTimeout(resolve, Math.max(waitMs, 0)));
  }
}

多くのSDKは、429を自動的に再試行します。 たとえば、OpenAI Python SDK は既定で 2 回再試行し、.NET の標準の回復性ハンドラーは 3 回再試行し、Retry-After を尊重します。 SDK の再試行回数を使い切ると、コードがそのエラーを受け取るため、プランが依然として必要です。

アプリが 429 を処理することをテストする方法

開発中に 429 が表示されることはほとんどありません。 API は高速で、自分だけがユーザーであり、テスト データは小さいです。 そのため、429 の処理をテストする方法によって、ユーザーが見つける前にバグが見つかるかどうかが決まります。

自分のアプリで試す

Dev Proxy は、選択した API に対するアプリの要求をインターセプトし、API 独自のヘッダーとエラー形式で 429 を返しますが、アプリは実際の URL を呼び出し続けます。 また、Retry-After の時間になる前にアプリが再試行するタイミングも通知されます。

アプリが呼び出す API のプリセットをダウンロードし、それを使用して Dev Proxy を開始します。

devproxy config get github-rate-limiting
devproxy --config-file "~dataFolder/configs/github-rate-limiting/.devproxy/devproxyrc.json"

その後、通常どおりにアプリを実行し、どのように動作するかを確認します。 Dev Proxy をインストールするには、「Dev Proxy の設定」を参照してください。

次のステップ

参照

• レート制限とは
• スロットリングとは何ですか？
• GitHub API レート制限をアプリで処理する方法をテストする
• アプリが OpenAI レート制限を処理する方法をテストする
• .NET アプリでの再試行とタイムアウトのテスト