TikTok 錯誤 40103:刷新權杖已過期
TikTok 錯誤 40103 表示刷新權杖已過期,因此無法再續期該帳戶的存取權杖。Accounts API 的刷新權杖有效期為一年。TikTok 提供的修復方法是重新授權:帳戶擁有者需再次完成應用程式的授權流程,取得新的存取權杖與新的刷新權杖,並以此取代舊的一組權杖儲存。
easyCoexistence 會儲存每次 TikTok 續期所得的刷新權杖及其到期時間,並自動續期 24 小時的存取權杖,供 Claude、ChatGPT 或您自己的程式使用。
TikTok 對已過期刷新權杖的回傳代碼;修復方法是由用戶重新授權應用程式。
Accounts API 刷新權杖的有效期限。
refresh_token_expires_in 的秒數,在 TikTok 發出新權杖的示例中正好為一年。
重新授權所取得授權碼的有效期,且只可使用一次。
錯誤 40103 是什麼意思?
用於續期存取權杖的刷新權杖已超過到期時間。TikTok 的回傳代碼附錄將 40103 列為刷新權杖已過期。修復方法是使用有效的刷新權杖;要取得有效權杖,須請用戶透過用戶授權流程重新授權應用程式。在此之前,存取權杖無法續期,目前的存取權杖到達當日終點後,呼叫便會停止。
刷新權杖的有效期有多久?
一年。/tt_user/oauth2/token/ 的回應包含 refresh_token_expires_in,即刷新權杖到期前剩餘的秒數:TikTok 示例為 31,536,000 秒,正好一年。續期回應也會附上同一欄位,TikTok 的續期示例顯示為 28,484,364 秒,少於一年,因此應讀取每次回應中的數值,不要假設每次續期都重新計算一年。
如何修復?
請帳戶擁有者重新授權應用程式。分享 TikTok 帳戶持有人授權網址;對方批准後,TikTok 會以新的 auth_code 重新導向至應用程式的 redirect URL。授權碼有效期為 10 分鐘,且只可使用一次。於 /tt_user/oauth2/token/ 以此交換新的存取權杖與刷新權杖,並取代已儲存的一組權杖。若擁有者先前已批准相同的權限,TikTok 預設會略過授權頁面,直接將其送回。
40103 與 40107、40131 有何不同?
附錄中有三個代碼對應續期失敗,指向不同的檢查:
- 40103:刷新權杖已過期。只有重新授權才能取代它。
- 40107:刷新權杖無效或不正確,例如用於續期 Marketing API 權杖(該權杖永不過期)的刷新權杖。
- 40131:在 /
tt_user/oauth2/token/ 或 /tt_user/oauth2/refresh_token/ 出現的認證錯誤,原因可能是應用程式 ID 或密鑰有誤、授權碼已過期,或刷新權杖無效或已過期。
常見錯誤
- 等待 40103 出現才規劃下一次授權。refresh_token_expires_in 會事先提供到期日,讓您可以在續期中止前,先請擁有者重新授權。
- 假設每次續期都會重新計算一年。TikTok 的續期示例在 refresh_token_expires_in 中回傳不足一年的數值,因此應讀取每次回應的數值。
- 捨棄續期時回傳的刷新權杖。TikTok 參考文件指示應保留該權杖,供下次續期使用。
若 TikTok 拒絕續期,工具會回傳 TikTok 的代碼與訊息;在控制台重新連接該帳戶,即可發出新的一組權杖。每個連接每月由 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。
常見問題
Content Posting API 的刷新權杖也是一年嗎?
不是。TikTok for Developers 的刷新權杖(用於 Content Posting API)有效期為 180 天;一年有效期適用於 API for Business 的刷新權杖,其剩餘秒數會顯示於 refresh_token_expires_in。
過期的 TikTok 刷新權杖可以續期嗎?
不可以。TikTok 對 40103 的修復方法,是由帳戶擁有者重新授權,發出新的存取權杖與刷新權杖。
擁有者會再次看到 TikTok 的權限頁面嗎?
預設不會。若擁有者先前已批准相同權限,TikTok 會略過審閱頁面,並以新的授權碼重新導向至應用程式。
刷新權杖過期後,呼叫會怎樣?
在目前的存取權杖到達當日終點前,呼叫仍可運作。之後會以 40102 失敗,因為該權杖已無法續期。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期