錯誤代碼

本頁面說明 Instragram 圖形 API 可能傳回的錯誤訊息。以下回應範例顯示 3600 代碼和 2207004 子代碼並定義後續錯誤代碼的例子。

回應範例

{
  "error": 
    {
      "message": "The image size is too large.",
      "type": "OAuthException",
      "code": 36000,
      "error_subcode": 2207004,
      "is_transient": false,
      "error_user_title": "Image size too large",
      "error_user_msg": "The image is too large to download. It should be less than 8 MiB.",
      "fbtrace_id": "A6LJylpZRKw2xKLFsAP-cJh"
   }
 }

定義的錯誤代碼

HTTP 狀態代碼	代碼	子代碼	用戶訊息	建議的解決方案
`400`	`-2`	`2207003`	`It takes too long to download the media.`	下載影音素材時發生逾時。請再試一次。
`400`	`-2`	`2207020`	`The media you are trying to access has expired. Please try to upload again.`	產生新的容器編號並用它再試一次。
`400`	`-1`	`2207001`		Instagram 伺服器錯誤。請再試一次。
`400`	`-1`	`2207032`	`Create media fail, please try to re-create media`	無法建立影音素材容器。請再試一次。
`400`	`-1`	`2207053`	`unknown upload error`	上傳時發生了未知的錯誤。產生新的容器並用它再試一次。這應只會影響影片上傳。
`400`	`1`	`2207057`	`Thumbnail offset must be greater than or equal to 0 and less than video duration, i.e.` {video-length}	您輸入的縮圖位移超出影片時間長度的範圍。請新增右位移，以毫秒為單位。
`400`	`4`	`2207051`	`We restrict certain activity to protect our community. Tell us if you think we made a mistake.`	發佈動作疑似為垃圾訊息。我們限制某些動態以保護我們的社群。如果您能確定該發佈動作不是垃圾訊息，請告訴我們。
`400`	`9`	`2207042`	`You reached maximum number of posts that is allowed to be published by Content Publishing API.`	應用程式用戶已達其每日發佈限制。建議應用程式用戶隔日再試一次。
`400`	`24`	`2207006`	`The media with` {media-id} `cannot be found`	由於缺少權限或權杖已失效而可能發生的權限錯誤。產生新的容器並用它再試一次。
`400`	`24`	`2207008`	`The media builder with creation id =` {creation-id} `does not exist or has been expired.`	發佈容器時發生暫時性錯誤。在接下來的 30 秒至 2 分鐘內重試 1 至 2 次。如果沒有成功，請產生新的容器編號並用它再試一次。
`400`	`25`	`2207050`	`The Instagram account is restricted.`	應用程式用戶的 Instagram 專業帳號遭到停用、處於檢查點狀態或受到限制。建議應用程式用戶登入 Instagram 應用程式，並完成重新啟用帳號所需的任何應用程式動作。
`400`	`100`	`2207023`	`The media type` {media-type} `is unknown.`	輸入的影音素材類型不是預期的影音素材類型之一。請輸入正確的影音素材類型。
`400`	`100`	`2207028`	`Your post won't work as a carousel. Carousels need at least 2 photos/videos and no more than 10 photos/videos.`	請使用可接受的相片／影片數量後再試一次。
`400`	`100`	`2207035`	`Product tag positions should not be specified for video media.`	影片不支援 X／Y 座標。請禁止 X／Y 座標搭配影片使用。
`400`	`100`	`2207036`	`Product tag positions are required for photo media.`	圖像商品標籤必須包含 X／Y 座標。圖像需要 X／Y 座標。
`400`	`100`	`2207037`	`We couldn't add all of your product tags. The product ID may be incorrect, the product may be deleted, or you may not have permission to tag the product.`	用於標註項目的一或多個產品無效（已刪除、遭拒絕、應用程式用戶缺少權限、產品編號無效等）。請再次取得應用程式用戶的目錄和符合資格的產品，並允許應用程式用戶在標註時只使用這些產品編號。
`400`	`100`	`2207040`	`Cannot use more than` {max-tag-count} `tags per created media.`	應用程式用戶超出 @ 標籤的數量上限（20）。建議用戶使用較少的 @ 標籤。
`400`	`352`	`2207026`	`The video format is not supported. Please check spec for supported` {video} `format`	不支援的影片格式。建議應用程式用戶上傳 MOV 或 MP4（MPEG-4 Part 14）。請參閱影片規格。
`400`	`9004`	`2207052`	`The media could not be fetched from this uri:` {uri}	無法從提供的 URI 擷取影音素材。建議應用程式用戶確認該 URI 有效且公開可用。
`400`	`9007`	`2207027`	`The media is not ready for publishing, please wait for a moment`	檢查容器狀態並在其狀態為 `FINISHED` 時發佈。
`400`	`36000`	`2207004`	`The image is too large to download. It should be less than` {size}`.`	圖像檔案大小超過 8MB 的上限。建議應用程式用戶使用較小的圖像再試一次。
`400`	`36001`	`2207005`	`The image format` {current-image-format} `is not supported. Supported formats are:` {format}`.`	由於缺少權限或權杖已失效而可能發生的權限錯誤。產生新的容器並用它再試一次。
`400`	`36003`	`2207009`	`The submitted image with aspect ratio` {submitted-ratio} `cannot be published. Please submit an image with a valid aspect ratio.`	圖像的長寬比不在可接受的範圍內。建議應用程式用戶在 4:5 至 1.91:1 範圍內的圖像再試一次。
`400`	`36004`	`2207010`	`The submitted image's caption was` {submitted-caption-length} `characters long. The maximum number of characters permitted for a caption is` {maximum-caption-length}. `Please submit media with a shorter caption.`	用戶超過說明文字的字元數上限。建議用戶使用長度較短的說明文字。上限為 2,200 個字元、30 個主題標籤和 20 個 @ 標籤。