Ошибка TikTok 40103: срок действия refresh-токена истёк
Ошибка TikTok 40103 означает, что срок действия refresh-токена истёк, поэтому он больше не может продлить токен доступа аккаунта. Refresh-токен Accounts API действителен один год. Решение, которое предлагает TikTok: владелец аккаунта заново проходит авторизацию приложения. В ответ приходят новый токен доступа и новый refresh-токен, которые нужно сохранить вместо старой пары.
easyCoexistence хранит refresh-токен и срок его действия из каждого продления TikTok и сам продлевает 24-часовой токен доступа для Claude, ChatGPT или вашего собственного кода.
Код возврата TikTok для истёкшего refresh-токена; исправление: пользователь повторно авторизует приложение.
Срок действия refresh-токена Accounts API.
Секунды в refresh_token_expires_in: ровно один год в примере TikTok для недавно выданных токенов.
Срок действия кода авторизации из новой авторизации, который используется один раз.
Что означает ошибка 40103?
Refresh-токен, отправленный для продления токена доступа, уже просрочен. В перечне кодов возврата TikTok 40103 значится как истёкший refresh-токен. Исправление: использовать действующий refresh-токен, а чтобы его получить, попросить пользователя повторно авторизовать приложение через рабочий процесс авторизации пользователя. До этого токен доступа продлить нельзя, и вызовы перестанут работать, когда текущий токен дойдёт до конца своих суток.
Как долго действует refresh-токен?
Один год. Ответ от /tt_user/oauth2/token/ включает refresh_token_expires_in: количество секунд до истечения refresh-токена. В примере TikTok это 31 536 000, ровно год. Ответы на продление содержат то же поле, и в примере продления TikTok указано 28 484 364 секунды, то есть меньше года. Поэтому значение нужно брать из каждого ответа, а не считать, что каждое продление начинает новый год.
Как это исправить?
Попросите владельца аккаунта авторизовать приложение заново. Отправьте ему URL авторизации для владельца аккаунта TikTok. После одобрения TikTok перенаправит на URL перенаправления приложения с новым auth_code, который действует 10 минут и используется один раз. Обменяйте его в /tt_user/oauth2/token/ на новый токен доступа и новый refresh-токен и замените сохранённую пару. Если владелец уже одобрял те же разрешения, TikTok по умолчанию пропускает страницу проверки и сразу возвращает его в приложение.
Чем 40103 отличается от 40107 и 40131?
В перечне три кода для неудачного продления, и каждый указывает на разную проверку:
- 40103: refresh-токен истёк. Заменить его может только новая авторизация.
- 40107: refresh-токен недействителен или неверен, например отправлен для продления токена Marketing API, который не истекает.
- 40131: ошибка аутентификации в /
tt_user/oauth2/token/ или /tt_user/oauth2/refresh_token/, вызванная неверным ID или секретом приложения, истёкшим кодом авторизации либо недействительным или истёкшим refresh-токеном.
Распространённые ошибки
- Ожидание 40103, чтобы планировать следующую авторизацию. refresh_token_expires_in показывает дату заранее, поэтому владельца можно попросить до того, как продление прекратится.
- Предположение, что каждое продление запускает год заново. В примере продления TikTok refresh_token_expires_in возвращает меньше года, поэтому читайте значение из каждого ответа.
- Отбрасывание refresh-токена, который возвращает продление. В справочнике TikTok сказано сохранить его для следующего продления.
Если TikTok отказывает в продлении, инструмент возвращает код и сообщение TikTok, а повторное подключение аккаунта через панель управления выпускает новую пару токенов. От US$ 9 до US$ 0,75 за подключение в месяц, стоимость снижается по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Действуют ли refresh-токены Content Posting API тоже год?
Нет. Refresh-токены TikTok for Developers, которые использует Content Posting API, действуют 180 дней. Год относится к refresh-токенам API for Business, а оставшийся срок указан в refresh_token_expires_in.
Можно ли продлить просроченный refresh-токен TikTok?
Нет. Исправление TikTok для 40103 это новая авторизация владельцем аккаунта, которая выпускает новый токен доступа и новый refresh-токен.
Видит ли владелец страницу разрешений TikTok снова?
По умолчанию нет. Если он уже одобрял те же разрешения, TikTok пропускает страницу проверки и перенаправляет в приложение с новым кодом авторизации.
Что происходит с вызовами после истечения refresh-токена?
Они работают до конца суток текущего токена доступа, а затем завершаются с ошибкой 40102, так как токен больше нельзя продлить.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на