TikTok 錯誤 40100:請求過於頻繁
TikTok 錯誤 40100 表示請求受速率限制而被節流:TikTok 會在 HTTP 200 回應的內文中返回代碼 40100,因此單看狀態碼無法發現此問題。解決方法是暫停呼叫該端點,每分鐘限制後等待 5 分鐘,每日限制則等到 UTC 00:00 才恢復,之後改為發送較少但較大的請求。
easyCoexistence 會將 TikTok 的代碼及訊息返回給 Claude、ChatGPT 或你自己的程式碼,讓你的 AI 能分辨速率限制與失敗的貼文,並在重試前等候。
TikTok 在請求達到速率限制時返回的代碼,表示該請求已被節流。
TikTok 隨返回代碼發送的狀態,包括 40100 在內;只有內文中的代碼 0 才代表成功。
Accounts API 對每個已授權 TikTok 帳戶、每個端點設定的速率限制。
所有 Accounts API 端點合計,按開發者應用程式計算,Basic 級別;較高級別允許 1,000。
TikTok 表示達到每分鐘限制後,再次呼叫前應等候的時間。
帳戶每日透過 API 可發布的影片貼文數量上限,每分鐘最多六則。
錯誤 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 呼叫會計入三項限制:
- 每個已授權帳戶在每個 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 建立的貼文數量,而非每分鐘的呼叫次數,因此放慢呼叫速度並無法解決。
其工具每頁可讀取 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 監察
驗證日期