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

TikTok 錯誤 40103:刷新權杖已過期

TikTok 錯誤 40103 表示刷新權杖已過期,因此無法再續期該帳戶的存取權杖。Accounts API 的刷新權杖有效期為一年。TikTok 提供的修復方法是重新授權:帳戶擁有者需再次完成應用程式的授權流程,取得新的存取權杖與新的刷新權杖,並以此取代舊的一組權杖儲存。

easyCoexistence 會儲存每次 TikTok 續期所得的刷新權杖及其到期時間,並自動續期 24 小時的存取權杖,供 Claude、ChatGPT 或您自己的程式使用。

40103

TikTok 對已過期刷新權杖的回傳代碼;修復方法是由用戶重新授權應用程式。

1 year

Accounts API 刷新權杖的有效期限。

31,536,000

refresh_token_expires_in 的秒數,在 TikTok 發出新權杖的示例中正好為一年。

10 minutes

重新授權所取得授權碼的有效期,且只可使用一次。

錯誤 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 參考文件指示應保留該權杖,供下次續期使用。
使用 EasyCoexistence 完成這項設定

若 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 監察

驗證日期