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

TikTok 錯誤 40104:存取權杖為空

TikTok 錯誤 40104 表示請求送達時沒有附帶存取權杖。/business/video/list/ 和 /business/comment/list/ 等 Accounts API 端點,需要在名為 Access-Token 的請求標頭中傳入 TikTok 帳戶的權杖。請加入有效的權杖,即從 /tt_user/oauth2/token/ 取得,或以 refresh token 更新,然後重新發送請求。

EasyCoexistence 會為 Claude、ChatGPT 或您自己的程式所發出的每個呼叫,在 Access-Token 標頭中加入 TikTok 帳戶的現行權杖。

40104

TikTok 在存取權杖為空時回傳的錯誤代碼;解決方法是傳送有效的權杖。

Access-Token

Accounts API 端點中,負責攜帶 TikTok 帳戶權杖的必填標頭。

business_id

每次呼叫中指定 TikTok 帳戶的參數,其值為隨權杖一併回傳的 open_id。

Bearer

TikTok 為 TikTok 帳戶存取權杖回傳的 token_type,傳送時仍須放在 Access-Token 中。

錯誤 40104 是什麼意思?

TikTok 收到呼叫時,其中沒有任何存取權杖。錯誤代碼附錄將 40104 列為存取權杖為空,解決方法與其他權杖錯誤相同:使用有效的存取權杖後再試一次。請求確實已送達 TikTok,但其中沒有任何內容顯示應以哪項授權執行,因此 TikTok 將該呼叫視為未成功。

權杖應放在哪裡?

放在名為 Access-Token 的標頭中。從發布、留言到數據分析,Accounts API 參考文件都將 Access-Token 列為必填標頭,內容為 TikTok 帳戶所授權的權杖。帳戶本身則另以 business_id 指定,其值為隨權杖一併回傳的 open_id。

An Accounts API call with its token
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["item_id","caption","video_views"]'

標頭為何會變成空白?

權杖會在儲存至發出請求之間的某個環節遺失。以下是應檢查的地方:

  • 標頭名稱有誤。以 Authorization: Bearer 傳送的權杖,會令 Access-Token 留空,即使 TikTok 將權杖類型列為 Bearer。
  • 儲存權杖的變數為空,例如更新失敗但未有檢查其錯誤之後。
  • 權杖放在內文或查詢字串中,而非標頭。
  • 為 /tt_user/oauth2/token/ 與 /tt_user/oauth2/refresh_token/ 編寫的輔助函式被重用;這些端點不接受 Access-Token 標頭,因此該函式不會傳送任何標頭。

應如何修正?

在 Access-Token 中傳送權杖,並同時附上 business_id。若沒有可用的現有權杖,請先取得:在 refresh token 仍有效時,以 /tt_user/oauth2/refresh_token/ 更新;若已失效,則請帳戶擁有人重新授權應用程式。除錯時,請記錄標頭是否存在及其值的長度,而非權杖本身,因為 TikTok 提醒,持有權杖的任何人均可使用它。

常見錯誤

  • 將 40104 誤認為權杖已過期。權杖是缺失而非過時,因此在程式實際傳送之前,更新權杖並不會有任何改變。
  • 更新權杖後沒有傳遞新權杖。更新會回傳新的存取權杖,其後的呼叫必須在 Access-Token 中傳送該值。
  • 原封不動地重試請求。若沒有標頭,每次嘗試都會以相同方式抵達 TikTok,並得到相同的代碼。
使用 EasyCoexistence 完成這項設定

若 TikTok 仍回傳 40102、40104 或 40105,連接會即時標記為需要重新連接,並會向您發送電郵。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。

常見問題

可以用 Authorization: Bearer 傳送 TikTok 存取權杖嗎?

不可以。Accounts API 端點從 Access-Token 標頭讀取權杖,因此以 Authorization: Bearer 傳送的權杖會令該標頭留空,呼叫便會回傳 40104,即使 TikTok 將權杖類型列為 Bearer。

40104 與權杖過期是同一回事嗎?

不是。40104 表示完全沒有收到權杖;權杖過期會回傳 40102,無效或不正確的權杖則回傳 40105。

TikTok 權杖端點需要 Access-Token 嗎?

不需要。/tt_user/oauth2/token/ 與 /tt_user/oauth2/refresh_token/ 改為在請求內文中以 client_id 與 client_secret 識別應用程式。

business_id 可以取代權杖嗎?

不可以。business_id 指明呼叫涉及哪個 TikTok 帳戶,Access-Token 則攜帶代其行事的授權。每次呼叫兩者都必須提供。

繼續閱讀

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

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

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

驗證日期