Ошибки Instagram API: что означают распространённые коды
Чаще всего встречаются ошибка 190 при истёкшем или недействительном токене, коды 4, 17 и 80002 при ограничении частоты, 9004 для медиа, которое Meta не может загрузить, 9007 для видео, которое ещё обрабатывается, 9 при достижении дневного лимита публикаций и 10 с подкодом 2534022 для сообщения вне окна переписки. Каждая ошибка приходит в формате JSON с кодом, часто с подкодом, который называет конкретный случай, и сообщением.
easyCoexistence берёт на себя подключение, связанное с этими ошибками: он продлевает доступ к Instagram до истечения срока, проверяет аккаунт каждые 6 часов и отправляет вам письмо, когда нужно переподключение.
Код Graph API для токена доступа, который истёк, был отозван или недействителен по иной причине.
Код ошибки для лимита Instagram Business Use Case.
Подкод при коде 9 для аккаунта, который достиг дневного лимита публикаций через API.
Подкод при коде 9004 для медиа, которое Meta не смогла загрузить по указанному URL.
Подкод при коде 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 его запрашивает, а он истекает вскоре после ошибки.
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 запрашивает при обращении с проблемой. Он истекает вскоре после ошибки, поэтому запишите его в лог в момент ошибки.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на