Instagram API 錯誤:常見錯誤代碼的含義
最常見的 Instagram API 錯誤包括:190 表示存取權杖已過期或無效;4、17 及 80002 為速率限制;9004 表示 Meta 無法擷取媒體;9007 表示影片仍在處理中;9 為每日發佈上限;10 配合子代碼 2534022 表示私訊超出訊息時限。每個錯誤均以 JSON 格式回傳,包含 code、通常能指明具體情況的子代碼,以及 message。
easyCoexistence 負責處理這些錯誤的連接部分:在存取權限過期前續期 Instagram 存取權,每 6 小時檢查一次帳戶,並在需要重新連接時向您發送電郵。
Graph API 代碼,表示存取權杖已過期、被撤銷或以其他方式失效。
Instagram 的 Business Use Case 速率限制錯誤代碼。
子代碼(屬於代碼 9),表示帳戶已達每日 API 發佈上限。
子代碼(屬於代碼 9004),表示 Meta 無法從所提供的 URL 擷取媒體。
子代碼(屬於代碼 200),表示帳戶已關閉其 Instagram 訊息的存取權限。
如何解讀 Instagram API 錯誤?
每個錯誤都是 error 下的一個 JSON 物件。code 是大致類別,error_subcode 指明具體情況,通常比 code 更有用,message 則加以描述。許多錯誤還帶有 error_user_title 和 error_user_msg(供用戶閱讀的文字),以及 is_transient。fbtrace_id 用於識別該請求,供 Meta 支援查詢,且很快便會失效,因此出錯時應立即記錄。
存取及權限錯誤代表什麼?
以下為有關誰可以執行什麼操作的錯誤,以及各自的修正方法:
- 190:存取權杖已過期、被撤銷或以其他方式失效;子代碼 463 表示已過期,467 表示無效,460 表示密碼已更改。取得新權杖即可修正,對已連接帳戶而言,即是重新連接。
- 10:權限遭拒。權限從未獲授予,或已被移除。
- 200 至 299:缺少特定權限,例如代碼 200 配合子代碼 2534041,表示帳戶已關閉其訊息的存取權限。
- 25,子代碼 2207050:帳戶受限、已停用或需要安全驗證;擁有者必須登入 Instagram 應用程式,並完成其要求的步驟。
速率限制錯誤代表什麼?
這是節流限制,且全部均屬暫時性:
- 4:應用程式的呼叫次數過多;等候後重試,或減少請求量。
- 17:用戶的呼叫次數過多;處理方法相同。
- 80002:Instagram 的 Business Use Case 限制,按應用程式及帳戶,根據帳戶的曝光次數計算:每次曝光在 24 小時內可有 4,800 次呼叫。
- 613,子代碼 2534040:訊息呼叫次數過多;暫停,稍後再試。
與媒體有關的發佈錯誤代表什麼?
以下錯誤與檔案及其託管位置有關;只有逾時錯誤值得按現狀重試:
- 9004,子代碼 2207052:Meta 無法從 URL 擷取媒體;請確保其有效且為公開。
- -2,子代碼 2207003:下載時間過長;此錯誤值得再試一次。
- 36000,子代碼 2207004:圖片超過 8 MB。
- 36001,子代碼 2207005:不支援該圖片格式;請使用 JPEG。
- 36003,子代碼 2207009:長寬比超出 4:5 至 1.91:1 的範圍。
- 352,子代碼 2207026:不支援該影片格式;請使用 MOV 或 MP4。
與時間及上限有關的發佈錯誤代表什麼?
以下錯誤與時間及數量有關,大多可透過等候或重新開始來解決:
- 9007,子代碼 2207027:媒體尚未就緒;請等候媒體容器的
status_code顯示 FINISHED。 - 24,子代碼 2207008:容器不存在或已過期;在 30 秒至 2 分鐘內重試一至兩次,之後建立新的容器。
- -2,子代碼 2207020:媒體已過期;請建立新的容器。
- 9,子代碼 2207042:帳戶已達每日發佈上限;請於翌日再試。
- 100,子代碼 2207028:輪播需要 2 至 10 個項目。
- 36004,子代碼 2207010:標題過長;Meta 的上限為 2,200 個字元及 20 個 @ 標記,其參考文件列出 30 個主題標籤,但 Instagram 每則貼文只容許 5 個。
- 4,子代碼 2207051:Instagram 因疑似垃圾訊息而限制該操作。
訊息錯誤代表什麼?
以下為私訊及私人回覆所產生的錯誤:
- 10,子代碼 2534022:訊息在允許的時限以外發出;請等候對方再次傳送訊息。
- 100,子代碼 2534014:找不到相符的 Instagram 用戶;請使用 Webhook 中的 Instagram 範圍 ID,而非 Instagram 用戶 ID。
- 100,子代碼 2534025:該留言不能接受私人回覆。
- 100,子代碼 2534037:另一應用程式(包括 Meta 自家的 Business AI)控制該對話。
- 551,子代碼 1545041:對方目前無法接收。
洞察數據錯誤代表什麼?
洞察數據請求會以三種已記錄的方式失敗:
- 10,媒體的觀看人數不足,無法顯示洞察數據:限時動態指標低於 5。
- 已停用的指標(例如 2025 年 4 月 21 日起的曝光次數)會返回錯誤;請改為索取觀看次數。
- 當所請求的多個指標之一不支援所要求的細分時,會返回未知錯誤。
哪些錯誤值得重試?
只有暫時性的錯誤:代碼 1 及 2、Instagram 伺服器錯誤 2207001 及 2207032、下載逾時 2207003、短暫的 2207008,以及等候時間結束後的速率限制。其他錯誤在情況改變前會持續返回相同結果,包括檔案、URL、權限、帳戶狀態或用戶的時限,重試這些錯誤只會消耗速率限制。
常見錯誤
- 重試格式或大小錯誤。2207004、2207005、2207009 及 2207026 在媒體改變前會以相同方式失敗。
- 將 9007 視為失敗。影片仍在處理中;待媒體容器顯示 FINISHED 時再發佈。
- 只看代碼。代碼 10 及 100 涵蓋多種情況,子代碼才能指明是哪一種。
- 在日誌中遺漏 fbtrace_id。Meta 支援需要此 ID,而它會在錯誤發生後很快失效。
Claude、ChatGPT 或您自己的程式隨後以保持最新的權杖呼叫 Meta 官方 API。每個已連接帳戶每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。
常見問題
Instagram 的錯誤 190 代表什麼?
存取權杖已過期、被撤銷或以其他方式失效,例如更改密碼之後。取得新權杖即可修正;對已連接帳戶而言,即是重新連接。
為何發佈時出現 9004 錯誤?
Meta 無法從所提供的 URL 擷取媒體,子代碼 2207052。發佈前請檢查該連結是否有效且為公開,前方沒有登入要求。
9007 錯誤是什麼?
媒體容器中的影片仍在處理中,子代碼 2207027。請檢查媒體容器的 status_code,並於其顯示 FINISHED 後再發佈。
Instagram API 錯誤中的 fbtrace_id 是什麼?
失敗請求的識別碼,您回報問題時 Meta 支援會要求提供。它會在錯誤發生後很快失效,因此請在當時記錄到日誌中。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期