오류 코드

이 페이지에서는 Instagram 그래프 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.`	새 컨테이너 ID를 생성하고 이를 사용하여 다시 시도하세요.
`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}	입력한 썸네일 오프셋이 동영상 재생 시간을 벗어납니다. 적절한 오프셋(ms)을 추가하세요.
`400`	`4`	`2207051`	`We restrict certain activity to protect our community. Tell us if you think we made a mistake.`	스팸으로 의심되는 게시 작업입니다. Facebook에서는 커뮤니티를 보호하기 위해 특정 활동을 제한합니다. 해당 게시 작업이 스팸이 아닌 것을 확인할 수 있다면 알려주세요.
`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회 다시 시도하세요. 실패 시 새 컨테이너 ID를 생성하고 이를 사용하여 다시 시도하세요.
`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.`	항목을 태그하는 데 사용 중인 제품(하나 이상)이 올바르지 않습니다(예: 삭제됨, 거부됨, 앱 사용자에게 권한이 없음, 제품 ID가 올바르지 않음). 앱 사용자의 카탈로그와 대상 제품을 다시 가져오고 앱 사용자가 태그 시 해당 제품 ID만 사용하도록 허용합니다.
`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}`.`	이미지가 최대 파일 크기(8MiB)를 초과했습니다. 사용자에게 작은 이미지로 다시 시도하도록 안내합니다.
`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개를 사용할 수 있습니다.