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

Ошибка TikTok 40102: срок действия токена доступа истёк

Ошибка TikTok 40102 означает, что токен доступа, отправленный с запросом, истёк, и вызов эндпоинта нужно повторить с актуальным токеном. Токен доступа Accounts API действует один день. Чтобы обновить его, отправьте refresh-токен на /tt_user/oauth2/refresh_token/ и повторите вызов. Сам refresh-токен действует один год, после чего владелец аккаунта заново авторизует приложение.

easyCoexistence сам обновляет 24-часовой токен TikTok через refresh-токен заранее, до истечения срока, поэтому вызовы из Claude, ChatGPT или вашего кода уходят с актуальным токеном.

40102

Код возврата TikTok для истёкшего токена доступа; эндпоинт нужно вызывать с актуальным токеном.

1 day

Сколько времени действует токен доступа аккаунта TikTok из Accounts API.

86,400

Значение expires_in в секундах в примере TikTok для только что выданного токена доступа.

1 year

Сколько действует refresh-токен; после его истечения владельцу нужно снова авторизовать приложение.

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

Токен доступа, переданный в заголовке Access-Token, истёк. В перечне кодов возврата TikTok 40102 значится как истёкший токен доступа, и там сказано, что эндпоинт нужно вызывать с актуальным токеном. Исправить можно, используя действующий токен доступа и повторив запрос.

Код приходит в теле ответа. Большинство вызовов API for Business возвращают HTTP 200, и успешность вызова определяет код возврата, а не статус.

Сколько живёт токен доступа TikTok?

Один день в API for Business. Accounts API выдаёт токен доступа аккаунта TikTok, когда приложение обменивает код авторизации на /tt_user/oauth2/token/. В ответе срок действия указан в expires_in: 86 400 секунд в примере TikTok. Тот же ответ содержит refresh-токен, который действует один год; TikTok советует сохранять его для обновления токена доступа. Пользовательские токены доступа TikTok for Developers, которые использует Content Posting API, живут вместо этого 2 часа.

Как его обновить?

Отправьте refresh-токен на /tt_user/oauth2/refresh_token/ вместе с ID и секретом приложения и параметром grant_type со значением refresh_token. В ответе придут новый токен доступа и новый refresh-токен: сохраните оба, а дальше передавайте новый токен доступа в заголовке Access-Token и повторите неудавшийся вызов. Если обновлять токен до истечения дня, запросы вообще не будут уходить в TikTok с просроченным токеном.

Renew a TikTok account access token
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<APP_ID>",
    "client_secret": "<SECRET>",
    "grant_type": "refresh_token",
    "refresh_token": "<REFRESH_TOKEN>"
  }'

# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_in

Когда владельцу нужно авторизоваться заново?

Когда обновление больше невозможно. Refresh-токен действует один год, и документация TikTok говорит, что после его истечения разработчик просит владельца аккаунта заново авторизовать приложение через процесс авторизации. Владелец также может отозвать авторизацию в любой момент в приложении TikTok: Настройки и конфиденциальность, Безопасность, Управление разрешениями приложений. После этого вернуть доступ можно только новой авторизацией.

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

  • Обновлять токен только после того, как вызов не удался. Токен, который живёт один день, истекает каждый день, поэтому обновляйте его заранее и не допускайте, чтобы запросы уходили в TikTok со старым токеном.
  • Игнорировать refresh-токен в ответе на обновление. В справочнике TikTok сказано сохранять его для следующего обновления, поэтому храните тот, который возвращает каждое обновление.
  • Проверять только HTTP-статус. TikTok обычно отвечает HTTP 200 и пишет 40102 в поле code, поэтому проверка одного статуса принимает ошибку за успех.
  • Хранить копии токена в нескольких местах. Если обновить одну копию, остальные дойдут до конца своего дня и завершатся ошибкой 40102.
Настройка с EasyCoexistence

Если TikTok всё равно отклоняет токен с 40102, 40104 или 40105, подключение сразу помечается для переподключения, и вы получаете e-mail. Свой код может получать актуальный токен из get_social_credentials, а не хранить копию. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.

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

Что означает expires_in в ответе TikTok с токеном?

Это число секунд до истечения токена доступа: 86 400, то есть один день, в примере TikTok для нового токена Accounts API. Прибавьте его к времени ответа, чтобы знать, когда обновлять токен, до появления 40102.

Можно ли обновить истёкший токен доступа TikTok?

Да, пока действителен refresh-токен. Отправьте его на /tt_user/oauth2/refresh_token/, и TikTok вернёт новый токен доступа и refresh-токен.

Означает ли ошибка 40102, что аккаунт нужно переподключить?

Сама по себе нет. Действующий refresh-токен обновляет доступ без участия владельца; новая авторизация нужна только тогда, когда refresh-токен истёк или владелец отозвал доступ.

Почему ответ с HTTP 200 содержит ошибку 40102?

Коды возврата TikTok важнее HTTP-статуса. Вызов считается успешным, только если его код равен 0, что бы ни было написано в строке статуса.

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

Ошибка TikTok 40105: токен доступа недействителен или неверенОшибка TikTok 40105: токен доступа недействителен или неверен. Что проверить в токене, как его обновить и когда владельцу нужно авторизоваться заново.Ошибка TikTok 40104: токен доступа пустОшибка TikTok 40104 означает, что запрос дошёл до API без токена доступа. Где Accounts API ожидает токен и как он пропадает.Ошибка TikTok 40103: срок действия refresh-токена истёкОшибка TikTok 40103: истёк срок refresh-токена, и доступ нельзя продлить. Refresh-токены Accounts API действуют один год. Решение: новая авторизация.Ошибка TikTok 40131: ошибка аутентификации на эндпоинтах токеновОшибка TikTok 40131 возникает при получении или обновлении токена: неверный ID или секрет приложения, истёкший код или недействительный токен обновления.Ошибка TikTok 40001: нет разрешения на операциюОшибка TikTok 40001 означает, что у вызывающего приложения нет разрешения на операцию. Как проверить разрешение TikTok Accounts у приложения и scope токена.TikTok API for Business против Content Posting APIПочему API for Business от TikTok, а не developers.tiktok.com: комментарии и их вебхук, инсайты, какие аккаунты подключаются и как обновляются токены.

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

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

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

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