TikTok API 連接為何停止運作,以及如何保持連接暢通
當 TikTok API for Business 連接的 24 小時存取權杖未獲更新、一年期刷新權杖到期、擁有者移除應用程式的存取權,或傳送的權杖缺失或錯誤時,連接便會停止運作。TikTok 將權杖相關情況回報為 40102、40103、40104 及 40105。及早更新、按時程檢查每個帳戶,並在年期屆滿前要求擁有者重新授權,即可讓連接持續有效。
easyCoexistence 會自行維持每個 TikTok 連接:提前更新 24 小時權杖,約每 6 小時檢查一次帳戶;當 TikTok 拒絕權杖時,會將頻道標記為「需要重新連接」並向您發送電郵,適用於 Claude、ChatGPT 或您自己的平台。
TikTok 帳戶存取權杖在 API for Business 中的有效期;/tt_user/oauth2/refresh_token/ 用於更新該權杖。
刷新權杖的有效期;到期後,帳戶擁有者必須重新授權應用程式。
擁有者在 TikTok 處理帖文時移除應用程式存取權所產生的失敗原因;TikTok 表示不應重試。
擁有者授權到期或被撤銷後,TikTok 停止為該帳戶發送的事件。
TikTok for Developers 的 authorization.removed 觸發原因:用戶斷開連接、帳戶被刪除、年齡變更、遭封禁,或開發者撤銷授權。
easyCoexistence 檢查每個已連接 TikTok 帳戶的頻率;它會自行更新 24 小時權杖,並在需要重新連接時向您發送電郵。
為何 TikTok API 連接會停止運作?
原因有數種,大多與帳戶的權杖或擁有者的同意有關。部分會直接終止連接,另一些則令連接部分失效,部分呼叫被拒絕,其餘仍可正常回應:
每個原因回傳哪個錯誤,應如何修復?
TikTok 的 code 欄位標示大部分原因,並放在 HTTP 200 回應內,而非錯誤狀態;發佈狀態另有其失敗原因。40100 列於表中,因為遭限流的呼叫可能看似連接已遺失。以下為各項含義及修復方法:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause 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及事件目的地。
設定方法
- 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.
- 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.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- 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.
- 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,之後同一權杖便會繼續有效。
每個連接每月 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 監察
驗證日期