登入開始免費試用
easyCoexistence 官方 API

TikTok 錯誤 40100:請求過於頻繁

TikTok 錯誤 40100 表示請求受速率限制而被節流:TikTok 會在 HTTP 200 回應的內文中返回代碼 40100,因此單看狀態碼無法發現此問題。解決方法是暫停呼叫該端點,每分鐘限制後等待 5 分鐘,每日限制則等到 UTC 00:00 才恢復,之後改為發送較少但較大的請求。

easyCoexistence 會將 TikTok 的代碼及訊息返回給 Claude、ChatGPT 或你自己的程式碼,讓你的 AI 能分辨速率限制與失敗的貼文,並在重試前等候。

40100

TikTok 在請求達到速率限制時返回的代碼,表示該請求已被節流。

HTTP 200

TikTok 隨返回代碼發送的狀態,包括 40100 在內;只有內文中的代碼 0 才代表成功。

40 QPM

Accounts API 對每個已授權 TikTok 帳戶、每個端點設定的速率限制。

600 QPM

所有 Accounts API 端點合計,按開發者應用程式計算,Basic 級別;較高級別允許 1,000。

5 minutes

TikTok 表示達到每分鐘限制後,再次呼叫前應等候的時間。

15 a day

帳戶每日透過 API 可發布的影片貼文數量上限,每分鐘最多六則。

錯誤 40100 是什麼意思?

速率限制使請求被停止。TikTok 的返回代碼附錄將 40100 描述為請求過於頻繁,原因是該端點在開發者應用程式層級已達到限制;其速率限制指南則說明,一旦達到限制,伺服器便會返回 40100。在暫停期結束之前,該端點的呼叫須暫停。

如何在程式碼中偵測 40100?

應檢查內文中的代碼,而非 HTTP 狀態。TikTok 隨 HTTP 200 發送返回代碼,因此須在每個回應中檢查 code 欄位:0 表示成功,40100 表示請求被節流。4xx 狀態指向錯誤的路徑或方法;遇到 5xx 時,TikTok 建議等候約 5 分鐘後重試:

Reading TikTok's answer in Node.js
// 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 呼叫會計入三項限制:

  • 每個已授權帳戶在每個 Accounts API 端點每分鐘 40 次查詢,各應用程式級別相同。
  • Basic 級別的每個開發者應用程式於整個 Accounts API 每分鐘 600 次查詢,以上級別為 1,000 次。
  • 各端點的應用程式限制按秒、分鐘及日計算,由應用程式的級別決定。

應等候多久?

視乎觸發的是哪項限制。每分鐘限制後,TikTok 建議等候 5 分鐘再呼叫。每日限制後,須等到翌日,因為每日限制於 UTC 00:00:00 重設。TikTok 的指南補充,端點專屬限制互不影響,因此達到某一端點的限制,並不會阻止對另一端點的呼叫。

15 則貼文的每日上限是同一限制嗎?

不是。發布上限計算的是貼文數量,即每個帳戶在每個發布端點每分鐘六則、每日 15 則。超出上限的貼文會在其發布狀態中失敗,錯誤為 spam_risk_too_many_posts,而非 40100。TikTok 對此失敗的建議是從 TikTok 手機應用程式發布該貼文,發布限制頁面對此有詳細說明。

如何保持在限制之內?

TikTok 的建議是發出較少但較大的請求,並限制同時執行的請求數量。在 Accounts API 上,這意味著每個 /business/video/list/ 頁面最多讀取 20 則貼文,每個 /business/comment/list/ 頁面最多讀取 30 則留言,而非逐一獲取;或以權杖桶機制分隔呼叫;或將呼叫排入隊列,由固定數量的工作程序發送,失敗的任務會在延遲後返回隊列。

提升應用程式級別能否阻止 40100?

只有在觸發的是應用程式限制時才有效。每個應用程式起初都是 Basic 級別,TikTok 會逐級提升,由 Basic 至 Advanced,再至 Premium 及 Ultimate,申請須於 My Apps、App Detail、Authorization 下提出,並附上理由。TikTok 的 Accounts API 指南將每個帳戶及端點每分鐘 40 次的限制列為單一數字,與應用程式級別分開,因此一個繁忙的帳戶只需將呼叫間隔開便可解決。

常見錯誤

  • 立即重試。端點在暫停期結束前仍會被節流,因此快速重試只會消耗呼叫次數,卻無法成功。
  • 逐一獲取貼文或留言。每次列表呼叫最多返回 20 則貼文或 30 則留言,而每次呼叫都會計入每分鐘 40 次的限制。
  • 以緊密循環輪詢發布狀態。每次檢查都是對 /business/publish/status/ 的呼叫,而貼文 ID 最多需要三分鐘才會出現,因此應間隔檢查。
  • 將 spam_risk_too_many_posts 視為速率限制。它計算的是過去 24 小時內透過 API 建立的貼文數量,而非每分鐘的呼叫次數,因此放慢呼叫速度並無法解決。
使用 EasyCoexistence 完成這項設定

其工具每頁可讀取 30 則留言,一次最多 20 則貼文;publish_tiktok_post 會預先告知 AI,TikTok 將 API 發布上限定為每個帳戶每日約 15 則貼文。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,前 3 日免費試用。

常見問題

TikTok 在呼叫受速率限制時會返回 HTTP 429 嗎?

TikTok 的指南將受節流的呼叫描述為 HTTP 200 回應內文中的代碼 40100,並未提及 429 狀態,因此應檢查每個回應的 code 欄位。

TikTok 40100 節流會持續多久?

TikTok 表示,達到每分鐘限制後應等候 5 分鐘。每日限制於 UTC 00:00:00 重設,屆時解除。

easyCoexistence 會否在返回 40100 時自動重試呼叫?

不會自行重試。受節流的工具呼叫會連同代碼 40100 及 TikTok 的訊息返回給你的 AI;隊列中受節流的貼文會以該訊息失敗,並在「需要注意」下等候,直至你選擇重試。

40100 與 40016 有何不同?

TikTok 的附錄對兩者的描述相同,都是開發者應用程式層級的請求過於頻繁,修復方法亦相同:查閱速率限制指南。40133 則涵蓋廣告主層級。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期