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

Почему подключение TikTok API перестаёт работать и как его поддерживать

Подключение TikTok API for Business перестаёт работать, когда истекает его 24-часовой токен доступа без обновления, заканчивается год действия токена обновления, владелец удаляет доступ приложения или отправленный токен отсутствует либо неверен. TikTok возвращает эти случаи под кодами 40102, 40103, 40104 и 40105. Продление заранее, регулярная проверка каждого аккаунта и повторная авторизация владельцем до конца года помогают сохранить подключение.

easyCoexistence сам поддерживает каждое подключение TikTok: продлевает 24-часовой токен заранее, проверяет аккаунт примерно каждые 6 часов, а когда TikTok отклоняет токен, помечает канал как «Требуется переподключение» и пишет вам на почту.

24 hours

Срок жизни токена доступа аккаунта TikTok из API for Business; /tt_user/oauth2/refresh_token/ продлевает его.

1 year

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

auth_removed

Причина сбоя публикации, когда владелец удаляет доступ приложения во время её обработки TikTok; TikTok советует не повторять попытку.

comment.update

События, которые TikTok перестаёт отправлять для аккаунта после истечения или отзыва авторизации владельца.

5 reasons

Почему срабатывает authorization.removed в TikTok for Developers: пользователь отключается, аккаунт удаляется, меняется возраст, следует блокировка или разработчик отзывает доступ.

6 hours

Как часто easyCoexistence проверяет каждый подключённый аккаунт TikTok; он сам продлевает 24-часовой токен и пишет вам на почту, если нужно переподключение.

Почему подключение TikTok API перестаёт работать?

Причин немного, и большинство связано с токенами аккаунта или согласием владельца. Одни полностью прерывают подключение, другие оставляют его частично рабочим: часть вызовов отклоняется, остальные по-прежнему получают ответ:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

Какая ошибка возвращается при каждой причине и что её исправляет?

Поле code в ответе TikTok называет большинство из них; ответ приходит с HTTP 200, а не со статусом ошибки, а статус публикации добавляет собственную причину сбоя. Код 40100 включён в таблицу, потому что ограниченный вызов может выглядеть как потерянное подключение. Что значит каждая ошибка и как её исправить:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause the endpoint 5 minutes; the token still works

Как долго живут токены и когда их нужно продлевать?

В API for Business токен доступа живёт 24 часа, а expires_in в каждом ответе с токеном показывает оставшиеся секунды. Токен обновления живёт год, и его отсчёт идёт в refresh_token_expires_in. Продлевайте задолго до конца суток, по расписанию, а не после неудачного вызова, и сохраняйте токен обновления, который возвращает каждое продление: TikTok в описании этого поля советует его хранить. Считайте refresh_token_expires_in крайним сроком: в примере продления TikTok это значение уменьшается, а не начинает новый год.

Что происходит, когда владелец удаляет доступ приложения?

Приложение теряет разрешения Accounts API, которые выдал владелец, поэтому вызовы с этим токеном перестают работать. TikTok не документирует событие API for Business, которое об этом сообщает. Владелец может сделать это в любой момент в приложении TikTok: Настройки и конфиденциальность, Безопасность, Управление разрешениями приложений, Удалить доступ. Признаки проявляются в другом месте: публикация, которую обрабатывал TikTok, завершается ошибкой auth_removed, и повторять её TikTok не советует, а события comment.update для аккаунта перестают приходить.

Что меняет смена типа аккаунта в подключении?

TikTok не связывает с этим ни одну ошибку токена в своей документации; меняется то, что возвращает API. Данные, такие как unique_video_views, daily_new_followers и audience_activity, требуют Advanced Access или Verified Business Account, как и API Mentions и Business Messaging. У приватного аккаунта в privacy_level_options нет PUBLIC_TO_EVERYONE. С 16 октября 2026 года is_business_account равно true только для Verified Business Account, а has_advanced_access показывает Advanced Access. Поэтому чтение обоих полей в user.account.type показывает изменение до того, как вызов на нём споткнётся.

Как поймать мёртвое подключение раньше клиента?

Проверками, которые работают независимо от того, публикует ли кто-нибудь что-то:

  • Лёгкий вызов для каждого аккаунта по расписанию, например /business/get/ с полем username, который вернёт ошибку токена, как только токен перестанет работать.
  • /tt_user/token_info/get/, которому не нужны разрешения; он возвращает область действия токена, чтобы убедиться, что выданных прав всё ещё хватает для вызовов ваших функций.
  • refresh_token_expires_in при получении каждого ответа переводится в дату, и за недели до срока владельцу уходит напоминание.
  • Тишина по comment.update у аккаунта, который обычно получает комментарии, поскольку TikTok прекращает эти события после истечения или отзыва авторизации.
  • Подсчёт 40102, 40103, 40104 и 40105 по каждому аккаунту, чтобы один сбойный аккаунт выделялся среди многих.

Как переподключить аккаунт?

Повторной авторизацией того же аккаунта. Отправьте владельцу аккаунта TikTok ссылку авторизации с параметром state, который связывает возврат с аккаунтом, и disable_auto_auth=1, если владелец должен снова увидеть страницу разрешений. Обменяйте новый auth_code на /tt_user/oauth2/token/ в течение его 10 минут, затем замените оба сохранённых токена. open_id это специфичный для приложения идентификатор аккаунта в TikTok, поэтому сопоставьте новые токены с сохранённой записью по нему, а не создавайте вторую.

Истекают ли подключения Content Posting API так же?

Нет. TikTok for Developers, который обслуживает Content Posting и Display API, 2 ноября 2026 года обновил страницы о токенах: токены доступа пользователя истекают в течение 2 часов, а токены обновления живут 180 дней с момента первой выдачи. Токены обновления меняются при каждом продлении: успешное продление возвращает новый и сразу делает недействительным отправленный. Если сервер продолжает использовать замененный токен, последующие продления завершаются ошибкой, и пользователю нужно авторизоваться заново. Неверный токен обновления даёт invalid_grant, неверный токен доступа даёт access_token_invalid и HTTP 401, а вебхук authorization.removed сообщает, почему пользователь ушёл.

Что easyCoexistence делает, чтобы сохранить подключение TikTok?

Он продлевает и проверяет подключение сам и сообщает, когда исправить может только владелец:

  • Продление: перед вызовом, если остаётся меньше 15 минут, и во время проверки, если остаётся меньше 8 часов; каждый раз сохраняется новый токен обновления и его срок.
  • Одно продление за раз для каждого аккаунта, поэтому одновременно пришедшие вызовы используют общее.
  • Проверка: вызов /business/get/ для username аккаунта примерно каждые 6 часов.
  • Отклонённый токен, 40102, 40104 или 40105: канал получает статус «Требуется переподключение», владелец получает одно письмо, а платформа получает channel.disconnected с сообщением TikTok в поле disconnected_reason.
  • До этого инструменты отвечают, что аккаунту нужно переподключение, а запланированная публикация завершается со статусом reconnect, не доходя до TikTok.
  • Переподключение: кнопка «Connect TikTok» на странице канала или новая сессия подключения: вход выполняется заново, а account_id и адрес доставки событий сохраняются.

Как настроить

  1. Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
  2. Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
  5. Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.

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

  • Принимать тихий вебхук комментариев за тихий аккаунт. TikTok прекращает comment.update для аккаунта, когда заканчивается его авторизация, поэтому проверяйте аккаунт, а не ждите событий.
  • Переподключение с созданием новой записи. Сопоставляйте новые токены по open_id, специфичному для приложения идентификатору аккаунта в TikTok, и обновляйте сохранённую запись на месте, сохраняя её историю и настройки.
  • Повтор 40103 или 40107 с тем же токеном обновления. Ни одна из ошибок не снимается повтором: первой нужна новая авторизация, второй токен обновления из последнего ответа или новая авторизация.
  • Чтение 40100 как потерянного подключения. Это ограниченный вызов; приостановите эндпоинт на 5 минут или до 00:00 UTC после дневного лимита, и тот же токен продолжит работать.
Настройка с EasyCoexistence

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

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

Может ли подключение TikTok API работать бесконечно без владельца?

Нет. Продление поддерживает его самое большее в течение года действия токена обновления; после этого документированный путь TikTok это новая авторизация владельцем аккаунта.

Почему подключения TikTok сразу у нескольких аккаунтов перестали работать?

Сначала посмотрите на приложение, а не на аккаунты: код 40113 означает, что приложение заблокировано или его ID и секрет не совпадают, а TikTok может отозвать доступ приложения к Accounts API за злоупотребления.

Требует ли новая функция переподключения аккаунтов TikTok?

Да, если ей нужно разрешение (scope), которое владелец никогда не выдавал. Токен сохраняет разрешения, одобренные при авторизации, поэтому владельцу нужно снова авторизовать приложение, чтобы добавить новое.

Что происходит с запланированными публикациями TikTok, пока аккаунту нужно переподключение?

В easyCoexistence они в свой срок завершаются со статусом reconnect, не доходя до TikTok, владельцу приходит письмо, а Retry отправляет их, как только аккаунт снова подключён.

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

Токены доступа TikTok API for Business: 24 часа, обновление и отзывКак TikTok API for Business выдаёт токены аккаунта: обмен auth_code, токен доступа на 24 часа, токен обновления на год, обновление и отзыв.Автоматизация TikTok: что ведёт к ограничениям, официальный API и ботыЧто условия TikTok говорят об автоматизации, почему неофициальные боты ведут к ограничениям аккаунтов и как автоматизировать в рамках правил.TikTok API на Python и Node.js: рабочие примерыРабочий код TikTok API for Business на Python и Node.js: публикация видео и фото, комментарии, аналитика и вебхуки.Как подключить аккаунт TikTok к API или ИИ-агентуКак аккаунт TikTok подключается к API или ИИ-агенту: экран авторизации TikTok, разрешения, панель управления и ссылки подключения.Scope в TikTok API for Business: что открывает каждое разрешениеРазрешения API TikTok Accounts по именам TikTok: что открывает каждое, scope токена для полей и как проверить токен.Руководство по TikTok API на 2026 год: от приложения до первого постаПуть через TikTok API в 2026 году: выбор API, проверка приложения, разрешения, токены, публикация, статус, комментарии, вебхуки, аналитика, лимиты.

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

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

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

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