Ошибка TikTok 40102: срок действия токена доступа истёк
Ошибка TikTok 40102 означает, что токен доступа, отправленный с запросом, истёк, и вызов эндпоинта нужно повторить с актуальным токеном. Токен доступа Accounts API действует один день. Чтобы обновить его, отправьте refresh-токен на /tt_user/oauth2/refresh_token/ и повторите вызов. Сам refresh-токен действует один год, после чего владелец аккаунта заново авторизует приложение.
easyCoexistence сам обновляет 24-часовой токен TikTok через refresh-токен заранее, до истечения срока, поэтому вызовы из Claude, ChatGPT или вашего кода уходят с актуальным токеном.
Код возврата TikTok для истёкшего токена доступа; эндпоинт нужно вызывать с актуальным токеном.
Сколько времени действует токен доступа аккаунта TikTok из Accounts API.
Значение expires_in в секундах в примере TikTok для только что выданного токена доступа.
Сколько действует 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 с просроченным токеном.
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.
Если 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, что бы ни было написано в строке статуса.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на