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

Ошибки Instagram API: что означают распространённые коды

Чаще всего встречаются ошибка 190 при истёкшем или недействительном токене, коды 4, 17 и 80002 при ограничении частоты, 9004 для медиа, которое Meta не может загрузить, 9007 для видео, которое ещё обрабатывается, 9 при достижении дневного лимита публикаций и 10 с подкодом 2534022 для сообщения вне окна переписки. Каждая ошибка приходит в формате JSON с кодом, часто с подкодом, который называет конкретный случай, и сообщением.

easyCoexistence берёт на себя подключение, связанное с этими ошибками: он продлевает доступ к Instagram до истечения срока, проверяет аккаунт каждые 6 часов и отправляет вам письмо, когда нужно переподключение.

190

Код Graph API для токена доступа, который истёк, был отозван или недействителен по иной причине.

80002

Код ошибки для лимита Instagram Business Use Case.

2207042

Подкод при коде 9 для аккаунта, который достиг дневного лимита публикаций через API.

2207052

Подкод при коде 9004 для медиа, которое Meta не смогла загрузить по указанному URL.

2534041

Подкод при коде 200, когда аккаунт отключил доступ к своим сообщениям в Instagram.

Как читать ошибку Instagram API?

Каждая ошибка представляет собой объект JSON внутри error. code задаёт общую категорию, error_subcode называет конкретный случай и обычно полезнее, а 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, рассчитываемый для каждого приложения и аккаунта по показам аккаунта: 4 800 вызовов на показ за 24 часа.
  • 613, подкод 2534040: слишком много вызовов для сообщений; сделайте паузу и повторите попытку позже.

Что означают ошибки публикации, связанные с медиа?

Ошибки о файле и месте его размещения; только тайм-аут стоит повторять в текущем виде:

  • 9004, подкод 2207052: Meta не смогла загрузить медиа по URL; убедитесь, что ссылка действительна и открыта публично.
  • -2, подкод 2207003: загрузка заняла слишком много времени; эту ошибку стоит повторить.
  • 36000, подкод 2207004: изображение больше 8 МБ.
  • 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 не найден; используйте идентификатор Instagram из вебхука, а не ID пользователя Instagram.
  • 100, подкод 2534025: на этот комментарий нельзя ответить приватно.
  • 100, подкод 2534037: диалог контролирует другое приложение, включая собственный Business AI от Meta.
  • 551, подкод 1545041: человек сейчас недоступен.

Что означают ошибки статистики?

Запросы статистики завершаются неудачей тремя задокументированными способами:

  • 10: недостаточно зрителей, чтобы медиа показало статистику: метрика Stories меньше 5.
  • Снятая с поддержки метрика, например показы с 21 апреля 2025 года, возвращает ошибку; вместо неё запросите просмотры.
  • Неизвестная ошибка, когда одна из нескольких запрошенных метрик не поддерживает запрошенную разбивку.

Какие ошибки стоит повторять?

Только временные: коды 1 и 2, серверные ошибки Instagram 2207001 и 2207032, тайм-аут загрузки 2207003, кратковременную ошибку 2207008 и ограничения частоты после окончания ожидания. Все остальные ошибки дают тот же ответ, пока что-то не изменится: файл, URL, разрешение, состояние аккаунта или окно переписки с человеком. Повторные попытки по ним лишь расходуют лимит запросов.

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

  • Повторная попытка при ошибке формата или размера. Коды 2207004, 2207005, 2207009 и 2207026 повторяются, пока медиа не изменится.
  • Восприятие 9007 как сбоя. Видео ещё обрабатывается; публикуйте, когда контейнер покажет FINISHED.
  • Чтение только кода. Коды вроде 10 и 100 охватывают много случаев, а подкод называет именно этот.
  • Удаление fbtrace_id из логов. Служба поддержки Meta его запрашивает, а он истекает вскоре после ошибки.
Настройка с EasyCoexistence

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

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

Что означает ошибка 190 в Instagram?

Токен доступа истёк, был отозван или недействителен по иной причине, например после смены пароля. Новый токен исправляет ошибку, а для подключённого аккаунта это означает повторное подключение.

Почему публикация завершается ошибкой 9004?

Meta не смогла загрузить медиа по указанному URL, подкод 2207052. Проверьте, что ссылка действительна и открыта публично, без входа в систему, в момент публикации.

Что означает ошибка 9007?

Видео в контейнере ещё обрабатывается, подкод 2207027. Проверьте status_code контейнера и опубликуйте, когда он покажет FINISHED.

Что такое fbtrace_id в ошибке Instagram API?

Идентификатор неудачного запроса, который служба поддержки Meta запрашивает при обращении с проблемой. Он истекает вскоре после ошибки, поэтому запишите его в лог в момент ошибки.

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

Лимиты публикации в Instagram API: форматы, размеры и посты в деньЧто вмещает публикация через Instagram API и сколько их в сутки: JPEG до 8 МБ, Reels, Stories, подписи до 2 200 символов, 100 постов за 24 часа.Публикация Reels в Instagram через APIКак Instagram API публикует Reels: требования Meta к видео, контейнеры и время обработки, показ в Feed, обложки и метрики Reels.Instagram DM через API и 24-часовое окноКак работают личные сообщения Instagram через API: кому может писать аккаунт, окно 24 часа, приватные ответы и настройка «Allow access to messages».Модерация комментариев в Instagram через APIКак API Instagram читает комментарии, отвечает на них, скрывает и удаляет: публичные ответы, один личный ответ на комментарий в течение 7 дней и правила.События вебхука Instagram: комментарии, упоминания и личные сообщения (DM)Как комментарии, упоминания и DM из Instagram доходят до вашего эндпоинта: что содержит каждое событие, как подписываются доставки и что проверить.Статистика Instagram через API: метрики аккаунта и постовМетрики, которые API Instagram возвращает для аккаунта и каждого поста, Reels и Stories, с порогами Meta, задержками и переименованными метриками.

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

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

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

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