Instagram API 錯誤 100:參數無效與找不到媒體
Instagram API 錯誤 100 表示請求中的參數無效,子代碼會指出具體情況。子代碼 33 代表找不到媒體:對象 ID 不存在、無法以存取權杖的權限載入,或不支援該呼叫。其他子代碼涵蓋未知的媒體類型、輪播大小、@ 標記、私訊收件人及音訊搜尋。
easyCoexistence 在呼叫失敗時,會把 HTTP 狀態、Meta 的錯誤代碼及其訊息交回 Claude、ChatGPT 或你自己的程式,讓代理能修正 ID 或數值後再次嘗試。
Meta 在 Marketing API 錯誤參考中,對 Graph API 錯誤代碼 100 的稱呼。
代碼 100 之下的子代碼:對象 ID 不存在、因缺少權限無法載入,或不支援此操作。
代碼 100 之下的子代碼,指 Instagram 無法識別的媒體類型;容器需要其中一種預期類型。
代碼 100 之下的子代碼,指單一媒體上超過 20 個 @ 標記。
代碼 100 之下的子代碼,指私訊收件人沒有對應的 Instagram 用戶;Meta 要求使用 Instagram 範圍的 ID,而非用戶 ID。
Meta 在 Instagram 錯誤表中,為每個代碼 100 列出的 HTTP 狀態。
Instagram 的錯誤 100 是什麼意思?
請求中的參數無法被接受。Meta 的 Marketing API 參考將代碼 100 命名為 Invalid parameter,其訊息表則稱之為「Bad Parameter」錯誤,而 Instagram 的各行會將它與 error_subcode 及 error_user_msg 配對以縮小範圍,HTTP 狀態為 400。單憑代碼無法分辨情況,例如媒體類型錯誤與私訊收件人錯誤截然不同,因此在改動任何內容前,請先查看 error_subcode 和 error_user_msg。
子代碼 33 是什麼意思?
代表請求中的 ID 無法被此存取權杖觸及。Meta 的訊息寫道:「Unsupported get request. Object with ID does not exist, cannot be loaded due to missing permissions, or does not support this operation.」修正方法是確認該 ID 存在,且應用程式擁有存取它的權限。若是 POST 請求,Meta 的參考將子代碼 33 列為「Unsupported post request」。
什麼情況會使 ID 以子代碼 33 失敗?
在做其他檢查之前,請先逐一核對以下各項,每項對應 Meta 訊息的一部分:
- 對象存在:已刪除的帖文或輸入錯誤的 ID,不會有任何東西可以載入。
- 存取權杖屬於擁有該對象的帳戶,因為權限只能觸及授予權限的帳戶的數據。
- ID 類型正確:來自 POST /<
IG_ID>/media 的容器 ID,不等於media_publish所返回的媒體 ID。 - 節點支援該呼叫:透過提及找到的留言,除非由留言擁有者發出請求,否則須透過被提及的留言節點讀取。
- ID 來自同一次登入:來自 Instagram Login 整合的訊息 ID,在統一登入下格式不同。
哪些發佈子代碼與代碼 100 一起出現?
Meta 的 Instagram 錯誤表中有六行,各自關於媒體容器上的一個值。其中三行產品標記行只適用於設定了產品標記的情況,而 Meta 的概覽指出 Instagram Login 不支援產品標記:
- 2207023:媒體類型未知;容器接受 CAROUSEL、REELS 或 STORIES 作為
media_type。 - 2207028:輪播項目過少或過多;訊息仍寫 2 至 10,但 Meta 的發佈指南允許最多 20 個。
- 2207040:媒體上的 @ 標記超過 20 個;請減少數量。
- 2207035:為影片傳送了產品標記位置,但影片不接受任何位置。
- 2207036:為相片缺少產品標記位置,相片需要 x 和 y 座標。
- 2207037:Meta 無法加入產品標記;請只標記帳戶合資格名單內的產品。
哪些訊息子代碼與代碼 100 一起出現?
Meta 的訊息常見錯誤代碼將以下各項與代碼 100 一併列出,並附上各自的修正方法:
- 2534014:找不到相符的 Instagram 用戶;請傳送至 webhook 所提供的 Instagram 範圍 ID,因為不支援 Instagram 用戶 ID。
- 2534015:訊息資料無效;該內容不允許用於此訊息類型。
- 2534025:此留言不適用於私下回覆。
- 2534037:應用程式並非對話串的擁有者,因為另一應用程式(包括 Meta Business AI)持有該對話。
- 2534029:商家在政策違規問題解決前,被禁止透過 API 發送訊息。
哪些音訊子代碼與代碼 100 一起出現?
共有十一行屬於 /ig_audio,即音訊 API 的搜尋功能,運行於 Facebook Login 及統一登入。大部分涉及在 Reel 中替換受版權保護音樂的廣告流程:user_id 與 ig_user_id 同時傳送(9050)、product=ADS 缺少或無效的 purpose(9052)、audio_replacement_mode 缺少或無效(9056、9057)、search_query 缺少或不被允許(9058、9060)、ig_media_id 缺少、不是 Reel,或該 Reel 不含受版權保護的音樂(9054、9062、9055),以及 partnership_ad_code 的問題(9063、9064)。
媒體找不到與錯誤 100 有何不同?
發佈時回報媒體缺失時使用其他代碼。Meta 的表格中,代碼 24、子代碼 2207006 表示找不到媒體,可能是缺少權限或存取權杖已過期,修正方法是建立新容器;代碼 24、子代碼 2207008 表示容器不存在或已過期,可在 30 秒至 2 分鐘內重試一兩次;代碼 -2、子代碼 2207020 表示媒體已過期。代碼 100 配子代碼 33 則是一般情況,即權杖無法觸及的 ID。
為何同一呼叫以一種登入成功,改用另一種卻失敗?
因為三種設定在主機、權杖及功能上各有不同。Instagram Login 的呼叫發送至 graph.instagram.com,使用 Instagram User 存取權杖及 instagram_business_* 權限;而 Facebook Login 與統一登入則使用各自的 Graph 主機、權杖及 instagram_* 權限。Meta 的概覽指出,Instagram Login 不支援主題標籤搜尋、產品標記及合作夥伴廣告,而音訊 API 僅運行於另外兩種設定。在統一登入下,/me 不會返回 Instagram 帳戶,因此呼叫需使用 GET /me/assigned_instagram_accounts 所返回的 ID。
如何修正錯誤 100?
應根據子代碼修改請求,因為原樣重送只會得到相同的回應。子代碼 33 時,請用同一權杖以 GET 讀回該 ID,並確認它是已發佈的媒體 ID,而非容器 ID。發佈相關的子代碼,則修正訊息所指的數值。至於訊息,請回覆 webhook 所提供的 Instagram 範圍 ID。也請在記錄中保留 fbtrace_id,這是 Meta 用於該請求的支援識別碼。
常見錯誤
- 原樣重試子代碼 33。ID 或其權限有誤,Meta 在請求改變之前都會給出相同的答案。
- 將私訊發送至某人的 Instagram 用戶 ID。私訊需使用訊息 webhook 中的 Instagram 範圍 ID,Meta 對用戶 ID 會返回子代碼 2534014。
- 發佈後仍使用容器 ID。留言、洞察數據及之後的讀取,都應使用 media_publish 所返回的媒體 ID,而非容器 ID。
list_social_accounts 與 list_social_posts 提供這些呼叫所需的帳戶及媒體 ID。每個連接每月由 US$ 9 降至 US$ 0.75,連接越多越便宜,首 3 天免費試用。
常見問題
Instagram API 錯誤 100 值得重試嗎?
不應原樣重試。它涉及請求本身,即某個 ID、數值或參數,因此在該部分修正之前,相同的請求會一再返回相同的錯誤。
為何帖文已上線,Instagram 卻說對象不存在?
請檢查發送的是哪個 ID,以及使用的是哪個權杖。子代碼 33 也涵蓋權杖因缺少權限而無法載入的對象,例如來自其他帳戶的媒體。
代碼 100 配子代碼 2207023 是什麼意思?
所發送的 media_type 不是 Instagram 所識別的類型。容器接受 CAROUSEL、REELS 或 STORIES,單張圖片則不需 media_type;Meta 已於 2023 年 11 月 9 日停止支援 VIDEO。
代碼 100 代表我的 Instagram 帳戶受到限制嗎?
不是。受限的帳戶會顯示為代碼 25、子代碼 2207050;代碼 100 則與請求中的某個數值有關。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期