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

Токены доступа Instagram: долгоживущие токены, 60 дней и обновление

Долгоживущий токен доступа Instagram действует 60 дней и может быть обновлён ещё на 60, если ему не меньше 24 часов и он не истёк. При входе через Instagram Login выдаётся короткоживущий токен пользователя Instagram на один час, который серверная часть приложения обменивает на долгоживущий.

easyCoexistence сам поддерживает токен Instagram актуальным: продлевает доступ до истечения 60 дней, проверяет аккаунт каждые 6 часов и пишет вам на почту, когда нужно переподключение, поэтому Claude, ChatGPT или ваш код обращаются к официальному API Meta с актуальным токеном.

1 hour

Сколько действует короткоживущий токен пользователя Instagram, полученный при входе.

60 days

Сколько действует обновлённый долгоживущий токен, считая с даты обновления.

24 hours

Минимальный возраст долгоживущего токена, при котором Meta его обновит.

Once

Сколько раз можно обменять код авторизации входа; он действует 1 час.

Какой токен использует Instagram Login?

Токен доступа пользователя Instagram. Он соответствует OAuth 2.0, привязан к приложению и хранит данные о приложении, сроке действия, ID пользователя Instagram аккаунта и выданных разрешениях; он передаётся с каждым вызовом к graph.instagram.com. Facebook Login использует токены доступа пользователя Facebook или Страницы, а Unified Login использует токен доступа Business Integration System User.

Как приложение получает долгоживущий токен?

В два обмена после входа, оба с сервера. Вход перенаправляет с кодом, который действует один час и используется один раз. POST https://api.instagram.com/oauth/access_token с ID приложения Instagram и секретом превращает его в короткоживущий токен, ID пользователя в рамках приложения и выданные разрешения. GET https://graph.instagram.com/access_token с grant_type=ig_exchange_token и секретом приложения затем возвращает долгоживущий токен с expires_in в секундах.

1LoginRedirect with a code, valid 1 hour, usable once
2Short-lived tokenFrom api.instagram.com/oauth/access_token, valid 1 hour
3Long-lived tokenFrom graph.instagram.com/access_token, valid 60 days
4RefreshFrom graph.instagram.com/refresh_access_token, 60 more days

Как обновляется долгоживущий токен?

Запросом GET https://graph.instagram.com/refresh_access_token с grant_type=ig_refresh_token и текущим долгоживущим токеном. Ответ содержит токен, действующий 60 дней с момента обновления. Meta обновляет только при выполнении трёх условий:

  • Токен долгоживущий и ему не меньше 24 часов.
  • Он не истёк.
  • Владелец аккаунта предоставил разрешение instagram_business_basic.
Refreshing a long-lived token
GET https://graph.instagram.com/refresh_access_token
  ?grant_type=ig_refresh_token
  &access_token=<LONG_LIVED_TOKEN>

{
  "access_token": "<NEW_LONG_LIVED_TOKEN>",
  "token_type": "bearer",
  "expires_in": 5183944
}

Что происходит, когда токен истекает?

Он перестаёт работать окончательно. Долгоживущий токен, не обновлённый в течение 60 дней, истекает и больше не может быть обновлён, а вызовы с ним завершаются ошибкой Graph API 190: срок действия токена истёк. Вернуться можно только новым входом владельца аккаунта, который запускает обмен заново.

Почему обмены должны выполняться на сервере?

Потому что в них передаётся секрет приложения. Meta указывает, что запросы за долгоживущими токенами должны быть в серверном коде, а не в клиентском коде или в приложении, которое можно декомпилировать, и что секрет нельзя передавать клиенту, отправлять или хранить на устройстве.

Как вызывать Instagram через easyCoexistence, не работая с токеном?

Через инструменты MCP. publish_instagram_post, list_social_posts, list_social_comments, reply_to_comment, hide_comment, send_social_dm и get_social_insights действуют от имени аккаунта, а токен добавляет сам easyCoexistence на своей стороне. Токены Instagram не выдаются никогда (условия Meta), поэтому get_social_credentials возвращает только ID аккаунта Instagram и базовый адрес API; токен и его продление остаются за easyCoexistence.

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

  • Обмен токенами в браузере или мобильном приложении. Вызовы передают секрет приложения, который, по указанию Meta, должен оставаться в серверном коде.
  • Обновление токена в первый день. Meta обновляет долгоживущие токены только тогда, когда им не меньше 24 часов.
  • Повторное использование кода авторизации. Он действует один час и работает один раз; второй обмен отклоняется.
  • Использование ID приложения Meta и секрета для Instagram Login. Business Login for Instagram берёт ID приложения Instagram и секрет из настроек Instagram в панели управления приложением.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, с понижением по мере добавления подключений, с бесплатным пробным периодом в 3 дня.

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

Сколько действует токен доступа Instagram?

Короткоживущий токен действует один час. Долгоживущий действует 60 дней и может быть обновлён ещё на 60.

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

Один час, и обменять его можно только один раз; второй обмен с тем же кодом отклоняется.

Какие ID приложения и секрет использует Instagram Login?

ID приложения Instagram и секрет из настроек Instagram в панели управления приложением. Business Login for Instagram берёт их, а не собственные ID и секрет приложения Meta, для URL входа и обменов токенами.

Обновляет ли easyCoexistence токены Instagram?

Да. Он продлевает доступ до истечения срока, проверяет каждый аккаунт каждые 6 часов и отправляет письмо, когда нужно переподключение.

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

Instagram Login или Facebook Login для Instagram APIInstagram API с Instagram Login или с Facebook Login через страницу Facebook: что нужно каждой схеме, что она позволяет и чем они отличаются.Разрешения Instagram API: области доступа для каждой функцииРазрешения, которые API Instagram использует с Instagram Login: от instagram_business_basic до manage_insights и что нужно каждой функции.Ошибки Instagram API: что означают распространённые кодыЧастые ошибки Instagram API: истёкшие токены, лимиты частоты, медиа, которые Meta не может загрузить, дневной лимит публикаций, закрытые окна переписки.Какие аккаунты Instagram работают с API: бизнес, креатор или личныйAPI Instagram работает с профессиональными аккаунтами: бизнес и креатор. Какой выбрать, что меняется при переходе и как переключиться в приложении.События вебхука Instagram: комментарии, упоминания и личные сообщения (DM)Как комментарии, упоминания и DM из Instagram доходят до вашего эндпоинта: что содержит каждое событие, как подписываются доставки и что проверить.

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

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

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

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