Ошибка TikTok 40131: ошибка аутентификации на эндпоинтах токенов
Ошибка TikTok 40131 является ошибкой аутентификации на эндпоинтах /tt_user/oauth2/token/ и /tt_user/oauth2/refresh_token/, которые выдают и обновляют токены аккаунта TikTok. TikTok называет три причины: неверный ID или секрет приложения, истёкший код авторизации или недействительный либо просроченный токен обновления. Эндпоинт, который вернул ошибку, показывает, какой параметр проверить в первую очередь.
easyCoexistence выполняет оба вызова токенов за вас: обменивает код авторизации, как только TikTok возвращает вас после входа, и самостоятельно обновляет токен доступа на 24 часа с помощью токена обновления.
Код возврата TikTok для ошибки аутентификации на /tt_user/oauth2/token/ и /tt_user/oauth2/refresh_token/.
Срок действия кода авторизации Accounts API; каждый код можно использовать только один раз.
Срок действия токена обновления; после его истечения владелец должен заново авторизовать приложение.
HTTP-ошибка, которую в приложении TikTok указывают для вызова /tt_user/oauth2/refresh_token без завершающего слеша.
Что означает ошибка 40131?
Запрос на получение или обновление токена аккаунта TikTok не прошёл аутентификацию. В приложении с кодами возврата TikTok ошибка 40131 связана с двумя эндпоинтами: /tt_user/oauth2/token/, который обменивает код авторизации на токены, и /tt_user/oauth2/refresh_token/, который обновляет токен доступа. Пример сообщения: «Authorization code is expired.» Названо три частые причины:
- Неверный ID или секрет приложения.
- Код авторизации истёк.
- Токен обновления недействителен или просрочен.
Как исправить на /tt_user/oauth2/token/?
Проверьте три параметра, которые TikTok называет для этого эндпоинта: ID приложения, секрет и код авторизации. ID и секрет находятся в портале TikTok API for Business: «My Apps», затем «App Detail», затем «Basic Information». Код действует 10 минут и работает однократно, поэтому обменяйте его сразу после получения редиректа. Если код устарел, начните авторизацию заново. Параметр redirect_uri, отправленный вместе с ним, также должен совпадать с URL перенаправления, указанным в приложении.
Как исправить на /tt_user/oauth2/refresh_token/?
Отправьте действующий токен обновления. Убедитесь, что в запросе стоит токен обновления, последним сохранённый для этого аккаунта, а также правильные ID и секрет приложения. Если токен обновления истёк или больше не действителен, в приложении TikTok указано попросить пользователя авторизовать приложение снова. Это выдаст новый токен доступа и новый токен обновления.
Какие связанные коды указывают на одну причину?
В том же приложении есть более узкие коды для некоторых случаев, у каждого своё описание:
- 40103: токен обновления истёк, и пользователю нужно заново авторизовать приложение.
- 40107: токен обновления недействителен или неверен.
- 40110: код авторизации отменён, уже использован или истёк.
- 40113: приложение заблокировано или не существует; частые причины: неверный ID или секрет приложения.
Распространённые ошибки
- Потерянный завершающий слеш. В приложении TikTok отмечено, что /tt_user/oauth2/refresh_token без финального / может вернуть 404 page not found вместо кода возврата.
- Двойной обмен кода авторизации. Код работает один раз и 10 минут, поэтому повторно отправленный или перезагруженный обратный вызов (callback) не сможет использовать его снова.
- Просьба к владельцу авторизоваться заново до проверки ID и секрета приложения. Если они неверны, новая авторизация упадёт в том же месте.
- Использование учётных данных другого приложения. ID и секрет должны принадлежать тому приложению, которое авторизовал владелец аккаунта.
Если TikTok отказывает в обновлении, инструмент передаёт Claude, ChatGPT или вашему собственному коду код и сообщение TikTok, а повторное подключение аккаунта из панели управления запускает новую авторизацию. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений цена снижается, первые 3 дня бесплатно.
Часто задаваемые вопросы
Какие эндпоинты возвращают ошибку TikTok 40131?
/tt_user/oauth2/token/, который превращает код авторизации в токены, и /tt_user/oauth2/refresh_token/, который обновляет токен доступа.
Где находятся ID и секрет приложения TikTok?
В портале TikTok API for Business: «My Apps», затем «App Detail», затем «Basic Information».
Означает ли 40131 всегда, что владельцу нужно подключиться заново?
Нет. Неверный ID или секрет исправляются в настройках самого приложения. Новая авторизация нужна, когда истёк код авторизации или токен обновления.
Сколько действует код авторизации TikTok для запроса токена?
10 минут и только для одного обмена. После этого TikTok рекомендует начать шаги авторизации заново.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на