【えーぴーあいれーとりみっと】
APIレートリミット とは?
最終更新:
💡 呼び出しのペースを、APIのルールに合わせる
📌 このページのポイント
- 時間あたりの呼び出しなどに上限を設ける
- 利用者やAPIごとに、制限の条件が異なる
- 超過時は429などの応答とヘッダーを確認する
- 待ち時間や回数を決めて、再試行する
どうして、呼び出しの回数を制限するの?
毎分60回なら、60回まで呼べる?
上限を超えると、必ず429になる?
429 Too Many Requestsは、一定時間に呼び出しすぎたことを示すHTTP応答だよ。ただし全サービスが必ずこのコードを返すわけではない。GitHubの資料は403または429を説明している。応答の内容と、そのAPIの公式仕様を確認して判断しよう。
Retry-Afterが来たら、秒数だけ待てばよい?
Retry-Afterは待つ秒数か、HTTPの日付で表せるよ。必ず付くヘッダーでもない。サービスが案内する待ち時間やリセット情報に従おう。再試行を続けて失敗するなら、間隔を広げ、回数にも上限を決める。変更や送信を伴う処理は、重複実行しないかも確認するんだ。
制限にかかりにくい使い方は?
同じ情報を必要以上に何度も取らず、呼び出しのペースや同時実行を調整しよう。残り回数のヘッダーがあれば参考にするけれど、名前や値の意味はサービスによる。過去に見た料金プランや回数だけを使い続けず、対象APIの仕様と実際の応答を確認することが大切だね。
📖 おまけ:英語の意味
「API Rate Limit」 = APIの呼び出し頻度の制限
💬 rateは頻度や割合。通信のビット毎秒の速さと同じものではなく、何をどう数えるかはAPIの仕様によるよ。