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

Instagram API 錯誤:常見錯誤代碼的含義

最常見的 Instagram API 錯誤包括:190 表示存取權杖已過期或無效;4、17 及 80002 為速率限制;9004 表示 Meta 無法擷取媒體;9007 表示影片仍在處理中;9 為每日發佈上限;10 配合子代碼 2534022 表示私訊超出訊息時限。每個錯誤均以 JSON 格式回傳,包含 code、通常能指明具體情況的子代碼,以及 message。

easyCoexistence 負責處理這些錯誤的連接部分:在存取權限過期前續期 Instagram 存取權,每 6 小時檢查一次帳戶,並在需要重新連接時向您發送電郵。

190

Graph API 代碼,表示存取權杖已過期、被撤銷或以其他方式失效。

80002

Instagram 的 Business Use Case 速率限制錯誤代碼。

2207042

子代碼(屬於代碼 9),表示帳戶已達每日 API 發佈上限。

2207052

子代碼(屬於代碼 9004),表示 Meta 無法從所提供的 URL 擷取媒體。

2534041

子代碼(屬於代碼 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,而它會在錯誤發生後很快失效。
使用 EasyCoexistence 完成這項設定

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 監察

驗證日期