Коды ошибок

В этом документе описаны сообщения об ошибках, которые может возвращать 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.`	Сгенерируйте новый 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}	Введенный сдвиг для миниатюры не соответствует длительности видео. Укажите правильный сдвиг в миллисекундах.
`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.`	Временная ошибка при публикации контейнера. Сделайте 1–2 повторные попытки через 30 секунд, но не позже чем через две минуты. В случае неудачи сгенерируйте новый 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. Отключите эти координаты для видео.
`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 товара указан неправильно и т. д.). Заново получите каталоги пользователя и проверьте доступные товары в них. Разрешите пользователю использовать для меток только эти товары.
`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}`.`	Размер файла изображения превышает ограничение (8 МиБ). Посоветуйте пользователю выбрать изображение меньшего размера и повторить попытку.
`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 меток @.
`400`	`100`	`9050`	`Provide either user_id or ig_user_id, not both.`	`/ig_audio` получает `user_id` и `ig_user_id`. Отправляйте только один параметр. Предпочтительно `ig_user_id`.
`400`	`100`	`9052`	`Missing or invalid purpose for product=ADS.`	Установите `purpose=AUDIO_COPYRIGHT_REPLACEMENT`, в настоящее время единственный поддерживаемый дополнительный сценарий использования для `product=ADS`.
`400`	`100`	`9056`	`Missing required parameter audio_replacement_mode.`	Отправьте `audio_replacement_mode` в качестве одного из `auto`, `search` или `default`.
`400`	`100`	`9057`	`Invalid audio_replacement_mode value.`	Используйте `auto`, `search` или `default` (регистр не учитывается).
`400`	`100`	`9058`	`Missing required parameter search_query.`	`search_query` требуется, когда `audio_replacement_mode=search`. Добавьте ключевое слово для поиска.
`400`	`100`	`9060`	`The search_query parameter is only valid when audio_replacement_mode=search.`	Сократите `search_query` в режимах `auto`/`default` или установите `audio_replacement_mode=search`.
`400`	`100`	`9054`	`The ig_media_id parameter is required.`	Укажите FBID медиафайла Instagram (из `/me/media`) для видео Reels, в котором нужно заменить музыку, защищенную авторским правом.
`400`	`100`	`9062`	`The supplied ig_media_id refers to a non-Reel media.`	Обнаружение смены аудио поддерживает только видео Reels. Укажите FBID видео Reels.
`400`	`100`	`9055`	`This media does not contain copyrighted licensed music.`	Обнаружение смены аудио доступно только для видео Reels, содержащих музыку, защищенную авторским правом. Выберите видео Reels, у которого возникла проблема с авторским правом.
`400`	`100`	`9063`	`The supplied partnership_ad_code is invalid or expired.`	Сгенерируйте действительный код партнерской рекламы и повторите попытку.
`400`	`100`	`9064`	`The supplied partnership_ad_code does not match the ig_media_id.`	Используйте `partnership_ad_code`, сгенерированный для того же медиафайла, что и `ig_media_id`.
`403`	`200`		`The calling app is missing the ads_management permission for the target.`	Запросите и получите разрешение `ads_management` для целевого пользователя, а затем повторите попытку.
`403`	`10`	`9053`	`Ads audio swap discovery is not yet available.`	Это функция из выпуска с ограниченным доступом. Доступ ограничен. Свяжитесь со своим контактным лицом по работе с партнерами Meta.