TikTok 錯誤 40102:存取權杖已過期
TikTok 錯誤 40102 代表隨請求發送的存取權杖已過期,因此必須用最新的權杖呼叫端點。Accounts API 的存取權杖有效一天。請將更新權杖發送至 /tt_user/oauth2/refresh_token/ 以續期,然後重新執行該呼叫。更新權杖本身有效一年,期滿後,帳戶擁有人需要重新為應用程式授權。
easyCoexistence 會提前、自動以更新權杖為 24 小時的 TikTok 權杖續期,讓 Claude、ChatGPT 或您自己的程式以最新權杖發出呼叫。
TikTok 對已過期存取權杖的返回碼;端點必須用最新的權杖呼叫。
Accounts API 所發出的 TikTok 帳戶存取權杖的有效期。
TikTok 範例中,新發出的存取權杖的 expires_in 值(以秒計)。
更新權杖的有效期;期滿後,擁有人必須重新為應用程式授權。
錯誤 40102 是什麼意思?
Access-Token 標頭中的存取權杖已過期。TikTok 的返回碼附錄將 40102 列為存取權杖已過期,並指出端點需要用最新的權杖呼叫。解決方法是使用有效的存取權杖並重試。
返回碼載於回應主體中。TikTok API for Business 的大部分呼叫都會返回 HTTP 200,是否成功取決於返回碼,而非狀態碼。
TikTok 存取權杖的有效期是多久?
在 TikTok API for Business 上為一天。Accounts API 在應用程式於 /tt_user/oauth2/token/ 兌換授權碼時發出 TikTok 帳戶存取權杖,回應以 expires_in 列出其有效期,TikTok 的範例為 86,400 秒。同一回應亦附有更新權杖,有效期一年,TikTok 建議保留該權杖以用於更新存取權杖。TikTok for Developers 的使用者存取權杖(由 Content Posting API 使用)則只有 2 小時。
如何更新存取權杖?
將更新權杖發送至 /tt_user/oauth2/refresh_token/,並附上應用程式的 ID 與密鑰,以及 grant_type 設為 refresh_token。回應會包含新的存取權杖和更新權杖:兩者都要儲存,之後以新的存取權杖在 Access-Token 標頭中發送,然後重新執行失敗的呼叫。在當天期滿前更新,可避免呼叫以已過期的權杖抵達 TikTok。
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<SECRET>",
"grant_type": "refresh_token",
"refresh_token": "<REFRESH_TOKEN>"
}'
# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_in帳戶擁有人何時需要重新授權?
當無法再更新時。更新權杖有效一年,TikTok 文件指出,期滿後開發者須請帳戶擁有人透過授權流程重新為應用程式授權。擁有人亦可隨時在 TikTok 應用程式中撤銷授權,路徑為「設定與私隱」、「安全」、「管理應用程式權限」,之後重新授權便是恢復的方法。
常見錯誤
- 只在呼叫失敗後才更新。權杖有效一天,每天都會過期,因此應提前更新,避免呼叫以舊權杖抵達 TikTok。
- 忽略更新回應中的更新權杖。TikTok 的參考文件指出應保留該權杖供下次更新使用,因此每次更新回傳的權杖都要儲存。
- 只檢查 HTTP 狀態。TikTok 通常以 HTTP 200 回應,並將 40102 放在返回碼欄位中,單看狀態檢查會把失敗誤判為成功。
- 在多處保存權杖副本。只更新其中一份,其餘副本仍會在各自當天期滿,並以 40102 失敗。
若 TikTok 仍以 40102、40104 或 40105 拒絕該權杖,連接會立即標記為需要重新連接,並會發送電郵通知您。您的程式可改由 get_social_credentials 取得最新權杖,無需自行保存副本。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。
常見問題
TikTok 權杖回應中的 expires_in 是什麼意思?
是存取權杖在過期前的秒數:TikTok 範例中新 Accounts API 權杖為 86,400 秒,即一天。將它加上回應的時間,即可得知何時應在 40102 出現前更新。
已過期的 TikTok 存取權杖可以更新嗎?
可以,只要更新權杖仍然有效。將其發送至 /tt_user/oauth2/refresh_token/,TikTok 便會返回新的存取權杖和更新權杖。
錯誤 40102 是否代表必須重新連接帳戶?
本身不代表。有效的更新權杖無需擁有人即可續期存取;只有在更新權杖已過期,或擁有人已撤銷存取權限時,才需要重新授權。
為何 HTTP 200 的回應會含有錯誤 40102?
TikTok 的返回碼優先於 HTTP 狀態。只有返回碼為 0 時呼叫才算成功,不論狀態行顯示什麼。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期