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

TikTok API 連接為何停止運作,以及如何保持連接暢通

當 TikTok API for Business 連接的 24 小時存取權杖未獲更新、一年期刷新權杖到期、擁有者移除應用程式的存取權,或傳送的權杖缺失或錯誤時,連接便會停止運作。TikTok 將權杖相關情況回報為 40102、40103、40104 及 40105。及早更新、按時程檢查每個帳戶,並在年期屆滿前要求擁有者重新授權,即可讓連接持續有效。

easyCoexistence 會自行維持每個 TikTok 連接:提前更新 24 小時權杖,約每 6 小時檢查一次帳戶;當 TikTok 拒絕權杖時,會將頻道標記為「需要重新連接」並向您發送電郵,適用於 Claude、ChatGPT 或您自己的平台。

24 hours

TikTok 帳戶存取權杖在 API for Business 中的有效期;/tt_user/oauth2/refresh_token/ 用於更新該權杖。

1 year

刷新權杖的有效期;到期後,帳戶擁有者必須重新授權應用程式。

auth_removed

擁有者在 TikTok 處理帖文時移除應用程式存取權所產生的失敗原因;TikTok 表示不應重試。

comment.update

擁有者授權到期或被撤銷後,TikTok 停止為該帳戶發送的事件。

5 reasons

TikTok for Developers 的 authorization.removed 觸發原因:用戶斷開連接、帳戶被刪除、年齡變更、遭封禁,或開發者撤銷授權。

6 hours

easyCoexistence 檢查每個已連接 TikTok 帳戶的頻率;它會自行更新 24 小時權杖,並在需要重新連接時向您發送電郵。

為何 TikTok API 連接會停止運作?

原因有數種,大多與帳戶的權杖或擁有者的同意有關。部分會直接終止連接,另一些則令連接部分失效,部分呼叫被拒絕,其餘仍可正常回應:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

每個原因回傳哪個錯誤,應如何修復?

TikTok 的 code 欄位標示大部分原因,並放在 HTTP 200 回應內,而非錯誤狀態;發佈狀態另有其失敗原因。40100 列於表中,因為遭限流的呼叫可能看似連接已遺失。以下為各項含義及修復方法:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause the endpoint 5 minutes; the token still works

權杖的有效期多久,何時應更新?

在 API for Business 上,存取權杖的有效期為 24 小時,每次權杖回應中的 expires_in 會列出剩餘秒數;刷新權杖的有效期為一年,其倒數計時載於 refresh_token_expires_in。應在當天結束前及早更新,依排程進行,而非在呼叫失敗後才更新,並保存每次更新所回傳的刷新權杖,因為 TikTok 對該欄位的說明是須予保留。請將 refresh_token_expires_in 視為最後期限:在 TikTok 的更新示例中,它是倒數計時,而非開始新一年。

擁有者移除應用程式的存取權時,會發生什麼事?

應用程式會失去擁有者所授予的 Accounts API 權限,因此使用該權杖的呼叫會停止運作,而 TikTok 並無記載任何 API for Business 事件會就此發出通知。擁有者隨時可在 TikTok 應用程式中,依次前往「設定與私隱」、「安全性」、「管理應用程式權限」、「移除存取權」。其跡象見於他處:TikTok 正在處理的帖文會以 auth_removed 失敗,TikTok 表示不應重試;該帳戶的 comment.update 事件亦會停止送達。

帳戶類型變更會對連接造成什麼影響?

TikTok 文件中並無將此與任何權杖錯誤相關聯;改變的是 API 所回傳的內容。unique_video_views、daily_new_followers 及 audience_activity 等數據需要 Advanced Access 或已驗證的商業帳戶,Mentions 及 Business Messaging API 亦然,而私人帳戶的 privacy_level_options 不包括 PUBLIC_TO_EVERYONE。自 2026 年 10 月 16 日起,is_business_account 僅對已驗證的商業帳戶顯示 true,has_advanced_access 則顯示是否具備 Advanced Access,因此同時讀取 user.account.type 下的兩者,可在呼叫出錯前察覺帳戶類型的改變。

如何在客戶發現前察覺已失效的連接?

以下檢查不論有否帖文發佈都會執行:

  • 按排程為每個帳戶進行一次輕量呼叫,例如帶 username 欄位的 /business/get/,權杖一旦失效便會回傳權杖錯誤。
  • /tt_user/token_info/get/ 無須任何權限,會回傳權杖的權限範圍,用以確認授權仍涵蓋功能所呼叫的範圍。
  • 每次回應到達時,將 refresh_token_expires_in 換算為日期,並於數週前提醒擁有者。
  • 通常會收到留言的帳戶突然沒有 comment.update,因為 TikTok 在授權到期或被撤銷後會停止發送此類事件。
  • 依帳戶統計 40102、40103、40104 及 40105 的次數,使一個失敗的帳戶能在眾多帳戶中突顯出來。

如何重新連接帳戶?

重新執行同一帳戶的授權即可。分享 TikTok 帳戶持有人授權網址,並附上可將回傳與帳戶相連的 state 值;若擁有者應再次看到權限頁面,則加入 disable_auto_auth=1。於 10 分鐘內在 /tt_user/oauth2/token/ 兌換新的 auth_code,然後替換已儲存的兩個權杖。open_id 是 TikTok 為該帳戶提供的應用程式專屬 ID,因此應以此比對新權杖與已儲存的記錄,而不是另建一筆。

Content Posting API 的連接是否以同樣方式失效?

不是。TikTok for Developers(提供 Content Posting 及 Display API)於 2026 年 11 月 2 日更新了權杖頁面:用戶存取權杖於 2 小時內到期,刷新權杖則自首次發出起計可使用 180 天。其刷新權杖會輪換,因此每次成功刷新都會回傳新的刷新權杖,並立即令所傳送的舊權杖失效;若伺服器仍使用已被取代的權杖,之後的刷新便會失敗,用戶必須重新授權。無效的刷新權杖會以 invalid_grant 失敗,無效的存取權杖則以 access_token_invalid 及 HTTP 401 失敗,而其 Webhook authorization.removed 會說明用戶離開的原因。

easyCoexistence 如何維持 TikTok 連接?

系統會自行更新及檢查,並在只有擁有者可修復時通知您:

  • 更新:剩餘少於 15 分鐘時於呼叫前更新,剩餘少於 8 小時時於檢查期間更新,每次均儲存新的刷新權杖及其到期時間。
  • 每個帳戶同時只進行一次更新,因此同時到達的呼叫會共用該次更新。
  • 檢查:約每 6 小時為帳戶的 username 進行一次 /business/get/ 呼叫。
  • 權杖被拒(40102、40104 或 40105)時,該頻道顯示「需要重新連接」,擁有者收到一封電郵,平台則收到 channel.disconnected,並以 TikTok 的訊息作為 disconnected_reason。
  • 在此之前,工具會回覆該帳戶需要重新連接,而已排程的帖文會以 reconnect 失敗,不會送往 TikTok。
  • 重新連接:在頻道頁面選擇「Connect TikTok」,或建立新的連接工作階段,重新登入後會保留相同的 account_id 及事件目的地。

設定方法

  1. Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
  2. Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
  5. Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.

常見錯誤

  • 將安靜的留言 Webhook 誤認為帳戶安靜。TikTok 在授權結束後便會停止為該帳戶發送 comment.update,因此應主動檢查帳戶,而非等待事件。
  • 重新連接時建立新記錄。應以 open_id(TikTok 為該帳戶提供的應用程式專屬 ID)比對新權杖,並就地更新已儲存的記錄,保留其歷史及設定。
  • 以相同刷新權杖重試 40103 或 40107。兩者重試都不會消除:前者須重新授權,後者須使用最新回應中的刷新權杖或重新授權。
  • 將 40100 誤解為連接已遺失。這是遭限流的呼叫;暫停該端點 5 分鐘,或如屬每日上限,則暫停至 UTC 00:00,之後同一權杖便會繼續有效。
使用 EasyCoexistence 完成這項設定

每個連接每月 US$ 9 起,連接越多,價格越低,最低降至 US$ 0.75,首 3 天免費。

常見問題

TikTok API 連接可否在沒有擁有者的情況下永久有效?

不可以。更新最多只能延續至刷新權杖的一年期限;此後,TikTok 記載的途徑是由帳戶擁有者重新授權。

為何多個帳戶的 TikTok 連接同時失效?

應先檢查應用程式,再檢查帳戶:40113 表示應用程式已被封鎖,或其 ID 與密鑰不相符;TikTok 可因應用程式濫用而撤銷其 Accounts API 存取權。

新功能是否需要重新連接 TikTok 帳戶?

當新功能需要擁有者從未授予的權限範圍時,便需要。權杖會保留授權時所批准的權限範圍,因此擁有者須再次授權應用程式,才能加入新權限。

帳戶需要重新連接時,已排程的 TikTok 帖文會怎樣?

在 easyCoexistence 上,這些帖文會在預定時間以 reconnect 失敗,而不會送往 TikTok,擁有者會收到電郵;帳戶重新連接後,按「重試」即可發送。

繼續閱讀

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

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

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

驗證日期