ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Статус медиаконтейнера Instagram: коды и жизненный цикл

API Instagram публикует через медиаконтейнеры, и каждый сообщает свой status_code: IN_PROGRESS, пока идёт публикация; FINISHED, когда контейнер готов; PUBLISHED, когда медиа уже опубликовано; ERROR, если завершить не удалось; и EXPIRED, если 24 часа прошли без публикации. Meta рекомендует проверять статус раз в минуту, не дольше 5 минут.

easyCoexistence выполняет цикл контейнера внутри publish_instagram_post: он создаёт контейнер, ждёт, пока Instagram завершит обработку, и публикует.

5

Значения, которые может принимать status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR и EXPIRED.

24 hours

Сколько времени контейнер может ждать публикации, прежде чем его статус станет EXPIRED.

1 min

Рекомендуемый Meta интервал между проверками статуса, не более 5 минут.

400

Сколько контейнеров аккаунт Instagram может создать в скользящем 24-часовом окне.

2207027

Подкод ошибки в рамках кода 9007 при публикации контейнера, который ещё не готов.

Что такое медиаконтейнер?

Объект, из которого публикуется пост. POST /<IG_ID>/media создаёт его из URL изображения или видео: Meta загружает и подготавливает медиа, а POST /<IG_ID>/media_publish с ID контейнера в параметре creation_id превращает его в пост. В карусели есть ещё один уровень: по контейнеру на каждый элемент, а затем контейнер CAROUSEL, который перечисляет их как дочерние.

Что означает каждый код статуса?

GET /<IG_CONTAINER_ID>?fields=status_code возвращает одно из пяти значений, у каждого свой следующий шаг:

  • IN_PROGRESS: контейнер ещё в процессе публикации; подождите и проверьте снова.
  • FINISHED: контейнер и его медиа готовы; опубликуйте его.
  • PUBLISHED: медиа уже опубликовано; публиковать больше нечего.
  • ERROR: контейнер не смог завершить процесс публикации; поле status содержит подкод ошибки с причиной, и нужен новый контейнер.
  • EXPIRED: он не был опубликован в течение 24 часов; создайте новый.
Checking a container's status
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code

{
  "status_code": "FINISHED",
  "id": "<IG_CONTAINER_ID>"
}

Как часто нужно проверять статус?

Раз в минуту, но не более 5 минут, рекомендует Meta. Проверка важнее всего для видео: Meta указывает, что загрузка видео асинхронна. Получение ID контейнера не гарантирует, что загрузка прошла успешно; подтверждает это только status_code FINISHED.

Что будет, если публиковать слишком рано?

media_publish завершается с ошибкой: код 9007, подкод 2207027, медиа не готово к публикации. В запросе ничего исправлять не нужно: проверьте статус и опубликуйте, когда он станет FINISHED. Код 24 с подкодом 2207008 означает другое: контейнер не существует или истёк. Meta советует повторить попытку один-два раза в течение от 30 секунд до 2 минут, а затем создать новый контейнер.

Сколько живёт контейнер?

24 часа. Контейнер, не опубликованный за это время, получает статус EXPIRED и больше не может быть опубликован. Код -2 с подкодом 2207020 (медиа истекло) тоже требует нового контейнера. Аккаунт может создать 400 контейнеров в скользящем 24-часовом окне, поэтому после неудачи есть возможность создать его заново.

Что ещё сообщает контейнер?

Два дополнительных поля и сведения о самой публикации. Поле status содержит подкод ошибки всякий раз, когда status_code принимает значение ERROR. copyright_check_status показывает для видео, выполнена ли проверка авторских прав Meta и нашла ли она совпадения. После публикации media_publish может вернуть config_issue, CAPTION_NOT_ATTACHED или USER_TAGGING_FAILURE, если пост вышел без подписи или без отметок пользователей.

Распространённые ошибки

  • Принимать ID контейнера за завершённую загрузку. Загрузка видео асинхронна, и только status_code FINISHED подтверждает, что медиа готово.
  • Публиковать, пока статус IN_PROGRESS. Вызов завершится с ошибкой, подкод 2207027, пока статус не станет FINISHED.
  • Держать контейнер больше суток. Через 24 часа без публикации он получает EXPIRED, и опубликовать можно только новый контейнер.
  • Ограничиваться status_code при сбое. Когда он равен ERROR, в поле status находится подкод, который называет причину.
Настройка с EasyCoexistence

Если видео ещё обрабатывается, публикация завершается самостоятельно. Claude, ChatGPT или ваш собственный код получают ID опубликованного медиа или статус обработки, пока easyCoexistence завершает публикацию. От US$ 9 до US$ 0,75 за подключённый номер в месяц, цена снижается по мере добавления номеров; первые 3 дня бесплатно.

Часто задаваемые вопросы

Что означает IN_PROGRESS у медиаконтейнера Instagram?

Meta ещё подготавливает медиа. Подождите и проверьте снова: публикация до того, как статус станет FINISHED, завершится с кодом 9007.

Сколько медиаконтейнеров может создать аккаунт Instagram?

400 в скользящем 24-часовом окне, поэтому после сбоя контейнер можно создать заново.

Что означает config_issue после публикации?

media_publish завершился успешно, но пост вышел без подписи (CAPTION_NOT_ATTACHED) или без отметок пользователей (USER_TAGGING_FAILURE).

Почему контейнер завершился со статусом ERROR?

Он не смог завершить процесс публикации. Поле status содержит подкод ошибки с причиной; устраните её и создайте новый контейнер.

Читайте дальше

Планирование публикаций в Instagram через APIКак работают запланированные посты Instagram через API: очередь хранит каждый пост и публикует его в заданное время, а медиа лежит по публичному URL.Установка обложки Reel через API InstagramОбложка Reel в Instagram через API: JPEG с cover_url или кадр видео с thumb_offset, требования Meta и правила обрезки обложек.Публикация Reels в Instagram через APIКак Instagram API публикует Reels: требования Meta к видео, контейнеры и время обработки, показ в Feed, обложки и метрики Reels.Лимиты публикации в Instagram API: форматы, размеры и посты в деньЧто вмещает публикация через Instagram API и сколько их в сутки: JPEG до 8 МБ, Reels, Stories, подписи до 2 200 символов, 100 постов за 24 часа.Ошибки Instagram API: что означают распространённые кодыЧастые ошибки Instagram API: истёкшие токены, лимиты частоты, медиа, которые Meta не может загрузить, дневной лимит публикаций, закрытые окна переписки.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на