glossaryplatform

APIレート制限とは? — 無料ツール

APIレート制限とは、一定の時間枠でアプリが送れるリクエスト数にプラットフォームが設ける上限です。ツールが到達したときに何が起きるのか、なぜ失敗ではなく遅延なのか、そして予約投稿と分析にとって何を意味するのかを解説します。

一定時間内にアプリが送れるAPIリクエスト数の上限です。上限に達すると、リセットされるまで投稿ツールや分析ツールが一時的に失敗します。

これは何か

レート制限とは、あるアプリケーションが一定の時間枠内に送れるAPIリクエスト数の上限として、プラットフォームが設ける天井のことです。15分あたり何回、1時間あたり何回、1日あたり何回、という形をとります。1つのアプリが全員の共有資源を食いつぶさないために存在し、対象はアプリケーションであってあなたではありません。

どう測るか

重要なのは「時間枠」で、そこがいちばん読み飛ばされます。1時間あたり1000回という制限は、1000回を均等に分けて送れるという意味ではありません。1分で全量を使い切って、残り59分待つこともできるという意味です。使い切るとプラットフォームは429を返し、多くの場合いつ枠がリセットされるかを示すヘッダーも付きます。行儀のよいツールはそのヘッダーを読んで待ちます。そうでないツールはすぐに再試行し、また拒否され、単なる遅延を「失敗」として報告してしまいます。

よくある誤解

アカウントに問題があるように見えますが、そうではありません。レート制限はあなたのプロフィールや投稿内容、アカウントの状態に対する評価ではまったくなく、だからこそこれが原因の公開遅延は、あなたが何も変えなくても自然に解消します。紛らわしいのは利用停止との違いです。外から見ると、制限に当たったアプリと、アクセス権を取り消されたアプリはどちらも「動かなくなった」に見えます。違いは、レート制限にはいつ終わるかが書いてあることです。

どんなときに重要か

多くの処理が同時に起きるときに問題になります。同じ分に予約された大きなまとまり、遡って埋めている1か月ぶんの分析、まとめて更新される複数アカウントなどです。だから公開ツールは正時に一斉送信せず作業を散らしますし、だから今朝欠けていた数値が午後にはたいてい入っています。

機能

  • 定義を平易に。要は「時間枠」であることを明確に
  • 429レスポンスとは何か、なぜあなたのアカウントのエラーではないのか
  • 分析の欠損と公開の遅れが同じ原因であることが多い理由
  • よくできたツールが即再試行せずに待つ仕組み
  • レート制限と利用停止の違い。外から見ると似ている点

よくある質問

レート制限に達すると何が起きますか。

枠がリセットされるまで、プラットフォームがそれ以降のリクエストを拒否します。通常は429レスポンスです。よくできたツールは待って再試行します。作りの粗いツールは、あなたのせいではない失敗を報告します。

制限に達するとアカウントに不利になりますか。

なりません。アプリケーションに対する上限であって、あなたへの罰ではありません。待たずに叩き続けるとアプリ自体が制限されることはありますが、それはそのアプリの状態であってあなたのプロフィールの話ではありません。

分析で1日ぶん欠けているのはなぜですか。

レート制限はよくある原因の1つです。指標は投稿ごとにプラットフォームへ問い合わせて集めるので、枠を使い切ると欠損が生じ、それは次の巡回で埋まります。永久に来ないわけではありません。

シャドウバンと同じものですか。

違います。どちらも「静かに動かなくなった」ように見えるので混同されますが、レート制限にはリセット時刻と明示的なレスポンスコードのある文書化された上限があります。配信の落ち込みにはそのどちらもありません。

制限を引き上げられますか。

ツールの利用者側からはできません。制限はプラットフォームがアプリごとに設定し、そのアプリに与えられたアクセス階層で決まるので、答えは常にツール側にあり、あなたの設定にはありません。