TikTok エラー 40100:リクエストの頻度が高すぎます
TikTok エラー 40100 は、レート制限によってリクエストが抑制されたことを意味します。TikTok はこのコードを HTTP 200 の応答の本文に返すため、ステータスだけでは判別できません。対処法は、そのエンドポイントへの呼び出しを一時停止することです。分単位の制限の後は 5 分、日単位の制限の後は UTC 00:00 まで待ち、その後は少数のまとまったリクエストに切り替えます。
easyCoexistence は TikTok のコードとメッセージを Claude、ChatGPT、またはお使いのコードに返すため、AI はレート制限と投稿の失敗を区別し、再試行前に待機できます。
レート制限に達すると TikTok が返すコードで、リクエストが抑制されたことを意味します。
TikTok が返信コードとともに送るステータスです。40100 もこの形式で返され、成功を示すのは本文のコード 0 のみです。
各エンドポイントにおける、認可済み TikTok アカウントごとの Accounts API のレート制限です。
Basic レベルのデベロッパーアプリごとの、Accounts API 全エンドポイント合計の上限です。上位レベルでは 1,000 まで許可されます。
分単位の上限に達した後、再度呼び出すまでに TikTok が指定する待機時間です。
アカウントが 1 日に API 経由で公開できる動画投稿の最大数で、1 分あたり最大 6 件です。
エラー 40100 は何を意味しますか?
レート制限によってリクエストが抑制されたことを意味します。TikTok の戻りコード一覧では、40100 を「リクエストの頻度が高すぎます」と説明しています。これはデベロッパーアプリのレベルで、そのエンドポイントの上限に達したためです。レート制限ガイドでも、上限に達するとサーバーが 40100 を返すと記載されています。制限が解除されるまで、そのエンドポイントへの呼び出しは一時停止する必要があります。
コードで 40100 をどう検出しますか?
HTTP ステータスではなく、本文のコードで判断します。TikTok は戻りコードを HTTP 200 で返すため、各応答の code を確認してください。0 は成功、40100 は抑制されたリクエストを意味します。4xx は誤ったパスやメソッドを示し、5xx の場合 TikTok は再試行前に約 5 分待つよう勧めています:
// TikTok returns its error codes with HTTP 200: read code, not only the status.
async function callTikTok(url, accessToken) {
const res = await fetch(url, { headers: { "Access-Token": accessToken } });
if (res.status >= 500) return { retryInMs: 5 * 60_000 }; // TikTok: wait about 5 minutes
if (!res.ok) throw new Error("HTTP " + res.status + ": check the path and the method");
const body = await res.json();
if (body.code === 40100) return { retryInMs: 5 * 60_000 }; // throttled: pause this endpoint
if (body.code !== 0) throw new Error("TikTok " + body.code + ": " + body.message);
return { data: body.data };
}どの制限で 40100 が返りますか?
TikTok のレート制限ガイドでは、制限に達するとサーバーが 40100 を返すと記載されています。各制限は個別にカウントされ、アプリレベル別の完全な数値はレート制限のページにあります。Accounts API の呼び出しは 3 つの制限にカウントされます:
- 各 Accounts API エンドポイントで、認可されたアカウントごとに毎分 40 クエリ。アプリのレベルに関係なく同じです。
- Basic の場合はデベロッパーアプリごとに Accounts API 全体で毎分 600 クエリ、それ以上では 1,000 クエリです。
- アプリのレベルで決まる、秒・分・日単位のエンドポイント別アプリ制限。
どのくらい待つべきですか?
どの制限に達したかによります。分単位の制限の後は、再度呼び出すまで 5 分待ちます。日単位の制限の後は翌日まで待ちます。日単位の制限は UTC 00:00:00 にリセットされるためです。TikTok のガイドによると、エンドポイント別の制限は互いに独立しているため、一つのエンドポイントの上限に達しても、他のエンドポイントへの呼び出しは止まりません。
1 日 15 件の投稿上限も同じ制限ですか?
いいえ。公開の上限は投稿数で数えられ、アカウントごとに各公開エンドポイントで 1 分あたり 6 件、1 日 15 件です。上限を超えた投稿は、40100 ではなく公開ステータスで spam_risk_too_many_posts により失敗します。TikTok がこの失敗に対して勧めているのは、TikTok のモバイルアプリから投稿を公開することです。詳細は投稿制限のページにあります。
制限内に収めるにはどうすればよいですか?
TikTok の推奨は、リクエストの回数を減らし、同時に実行する数を制限することです。Accounts API では、投稿を 1 件ずつ取得する代わりに、/business/video/list/ のページごとに最大 20 件の投稿を、/business/comment/list/ のページごとに最大 30 件のコメントを読み込みます。呼び出し同士はトークンバケットで間隔を空けるか、キューに入れて、決まった数のワーカーが送信するようにします。失敗したタスクは、遅延の後にキューへ戻します。
アプリレベルを上げれば 40100 は止まりますか?
アプリの上限に達していた場合に限ります。すべてのアプリは Basic から始まり、TikTok は「My Apps」「App Detail」「Authorization」の画面から理由を記載して申請すると、Advanced、Premium、Ultimate の順に 1 段階ずつ引き上げます。TikTok の Accounts API ガイドでは、アカウントとエンドポイントごとの毎分 40 の上限は、アプリのレベルとは別の一つの数値として示されています。そのため、利用の多いアカウントは呼び出し間隔を空けることで解決します。
よくある間違い
- すぐに再試行すること。エンドポイントは制限が解除されるまで抑制されたままなので、素早い再試行は呼び出し回数を消費するだけで成功しません。
- 投稿やコメントを 1 件ずつ取得すること。リスト呼び出しは最大 20 件の投稿または 30 件のコメントのページを返し、呼び出しごとに毎分 40 件の上限にカウントされます。
- 公開ステータスを密なループでポーリングすること。確認のたびに /business/publish/status/ を呼び出すことになり、投稿 ID が表示されるまで最大 3 分かかることがあるため、確認の間隔を空けてください。
- spam_risk_too_many_posts をレート制限として扱うこと。これは毎分の呼び出し数ではなく、過去 24 時間に API 経由で作成された投稿数を数えるため、呼び出しを遅くしても解決しません。
ツールはコメントを 1 ページあたり 30 件、投稿を最大 20 件ずつ読み取ります。publish_tiktok_post は、TikTok が API からの投稿をアカウントごとに 1 日約 15 件に制限していることを、事前に AI に伝えます。接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど料金が下がります。最初の 3 日間は無料トライアルです。
よくある質問
TikTok は、レート制限された呼び出しに HTTP 429 を返しますか?
TikTok のガイドでは、抑制された呼び出しは HTTP 200 の応答の本文にあるコード 40100 と説明されており、429 のステータスは記載されていません。そのため、各応答の code フィールドを確認してください。
TikTok の 40100 による抑制は、どのくらい続きますか?
分単位の上限に達した後は 5 分待つよう TikTok は勧めています。日単位の上限は UTC 00:00:00 にリセットされ、そのときに解除されます。
easyCoexistence は 40100 を返した呼び出しを自動で再試行しますか?
単独では再試行しません。抑制されたツール呼び出しは、コード 40100 と TikTok のメッセージを付けて AI に返されます。キュー内の抑制された投稿は、そのメッセージとともに失敗し、「要対応」に表示されて、「再試行」を選ぶまで待機します。
40100 と 40016 は違いますか?
TikTok の付録では、両方とも「デベロッパーアプリレベルでのリクエストの頻度が高すぎます」と同じ説明がされており、対処法も同じです。レート制限ガイドを確認してください。40133 は広告主レベルを扱います。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日