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

TikTok 錯誤代碼 40002:請求參數錯誤

TikTok 錯誤代碼 40002 屬於參數錯誤:請求中的某個欄位缺漏、格式有誤、不受支援,或與另一欄位不相容。回應的訊息會指明問題,例如缺少必填欄位。請對照端點的參考文件修正該欄位,例如 Accounts API 的 business_id、post_info 或 max_count,然後重新發送請求。

easyCoexistence 會為 Claude、ChatGPT 或你自己的程式代碼所發出的每次 TikTok 呼叫加入 business_id,並在發送前檢查貼文:影片或 1 至 35 張圖片,使用 HTTPS 連結,並拒絕 PNG 相片,因為 TikTok 只接受 JPEG 或 WebP。

40002

TikTok 針對參數錯誤的返回代碼,詳細資料載於回應訊息中。

HTTP 200

TikTok 範例 40002 回應的狀態碼:失敗由 code 欄位顯示,而非由狀態碼顯示。

2,200

透過 Accounts API,影片說明最多可容納的字元數(以 UTF-16 計算),包括最多 30 個提及。

1 to 30

/business/comment/list/ 的 max_count 每頁可接受的留言數量,預設為 20。

60 days

讀取帳戶數據分析時,/business/get/ 的 start_date 最遠可回溯的日期。

錯誤代碼 40002 是什麼意思?

一個或多個參數不符合端點的接受條件。TikTok 的返回代碼附錄將 40002 列為參數錯誤,並指示查看錯誤訊息以取得詳情。附錄列出的成因包括:必填欄位缺漏、格式不正確、欄位或值不受支援、欄位之間互不相容、資料準確度無效,以及無效的數值。

應如何解讀回應?

先看訊息,它會指明欄位。TikTok 自己的範例(見下文)以 HTTP 200 返回,訊息為「Missing required field(s): account_id.」附錄中另一個範例的訊息為「Time format should be %Y-%m-%dT%H:%M.」。請同時保留 request_id,因為 TikTok 的參考文件要求在問題報告中附上此項。

TikTok's example 40002 response
HTTPS/1.1 200 OK
{
    "code": 40002,
    "message": "Missing required field(s): account_id.",
    "request_id": "2022110918305001025108614416C7CC00"
}

哪些 Accounts API 規則值得檢查?

每個端點的參考文件各自訂定規則。以下規則適用於連接用於發佈、處理留言及讀取數據分析的呼叫:

  • 每次呼叫:business_id,須設為隨帳戶存取權杖一併返回的 open_id。
  • 影片貼文:video_url 與 post_info 均為必填,即使 post_info 為空也須提供;影片說明最多 2,200 個字元。
  • 相片貼文:photo_images 最多可含 35 個圖片網址、帳戶允許的 privacy_level,以及最多 90 個字元的標題。
  • 留言:video_id 為 /business/video/list/ 所返回貼文的 item_id,max_count 範圍為 1 至 30,comment_ids 最多接受 30 個。
  • 回覆:文字最多 1,200 個字元,或以圖片代替。
  • 數據分析:日期格式如 2021-06-01,以 UTC 計,回溯最多 60 天。

應如何修正?

在端點的參考文件中找出訊息所指的欄位,修正後重新發送請求。錯誤描述的是請求本身,因此原樣重送會得到相同代碼。對於依帳戶而定的值,例如私隱等級或能否開啟留言,請在發佈前先從 /business/video/settings/ 讀取可選項目。

媒體檔案出現問題又如何?

TikTok 在呼叫之後才回報這些問題。發佈端點會在 TikTok 下載檔案時返回發佈任務的 share_id;若檔案違反規則,/business/publish/status/ 會顯示 FAILED,並附上 file_format_check_failed、frame_rate_check_failed 或 picture_size_check_failed 等原因。TikTok 將這些原因標記為不可重試,因此必須更改檔案本身。

常見錯誤

  • 重複發送相同的請求。40002 描述的是參數,因此在修正訊息所指的欄位之前,結果不會改變。
  • 以純文字寫入陣列參數。像 fields 這類欄位須以 JSON 陣列傳送,如 TikTok 範例 ["display_name", "profile_image"]。
  • 為每個帳戶使用同一個私隱設定。公開與私人帳戶的選項各不相同,因此應先從 /business/video/settings/ 讀取 privacy_level_options。
  • 在留言已關閉的帳戶上將 disable_comment 設為 false。當 comment_disabled 為 true 時,TikTok 只接受 true。
使用 EasyCoexistence 完成這項設定

若 TikTok 仍返回 40002,工具會返回其代碼與訊息,讓你的 AI 修正欄位後再試。每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,前 3 天免費試用。

常見問題

TikTok API 中的參數錯誤是什麼?

即返回代碼 40002:請求中的某個欄位缺漏、格式有誤、不受支援,或與另一欄位不相容,訊息會指明是哪一個欄位。

為何 TikTok 會以 HTTP 200 返回 40002?

TikTok 的返回代碼優先於 HTTP 狀態碼,因此代碼不為 0 的 200 回應仍屬失敗的呼叫。

遇到錯誤代碼 40002 應否重試?

只有在修改請求之後才應重試。成因在於參數,因此應先修正訊息所指的欄位,再重新發送。

影片檔案的問題會在哪裡顯示?

會在發佈狀態中顯示。TikTok 下載媒體後,若檔案違反其規則,/business/publish/status/ 會顯示 FAILED,並附上指出未通過檢查項目的原因。

繼續閱讀

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

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

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

驗證日期