Почему подключение TikTok API перестаёт работать и как его поддерживать
Подключение TikTok API for Business перестаёт работать, когда истекает его 24-часовой токен доступа без обновления, заканчивается год действия токена обновления, владелец удаляет доступ приложения или отправленный токен отсутствует либо неверен. TikTok возвращает эти случаи под кодами 40102, 40103, 40104 и 40105. Продление заранее, регулярная проверка каждого аккаунта и повторная авторизация владельцем до конца года помогают сохранить подключение.
easyCoexistence сам поддерживает каждое подключение TikTok: продлевает 24-часовой токен заранее, проверяет аккаунт примерно каждые 6 часов, а когда TikTok отклоняет токен, помечает канал как «Требуется переподключение» и пишет вам на почту.
Срок жизни токена доступа аккаунта TikTok из API for Business; /tt_user/oauth2/refresh_token/ продлевает его.
Срок жизни токена обновления; после его истечения владельцу аккаунта нужно заново авторизовать приложение.
Причина сбоя публикации, когда владелец удаляет доступ приложения во время её обработки TikTok; TikTok советует не повторять попытку.
События, которые TikTok перестаёт отправлять для аккаунта после истечения или отзыва авторизации владельца.
Почему срабатывает authorization.removed в TikTok for Developers: пользователь отключается, аккаунт удаляется, меняется возраст, следует блокировка или разработчик отзывает доступ.
Как часто easyCoexistence проверяет каждый подключённый аккаунт TikTok; он сам продлевает 24-часовой токен и пишет вам на почту, если нужно переподключение.
Почему подключение TikTok API перестаёт работать?
Причин немного, и большинство связано с токенами аккаунта или согласием владельца. Одни полностью прерывают подключение, другие оставляют его частично рабочим: часть вызовов отклоняется, остальные по-прежнему получают ответ:
Какая ошибка возвращается при каждой причине и что её исправляет?
Поле code в ответе TikTok называет большинство из них; ответ приходит с HTTP 200, а не со статусом ошибки, а статус публикации добавляет собственную причину сбоя. Код 40100 включён в таблицу, потому что ограниченный вызов может выглядеть как потерянное подключение. Что значит каждая ошибка и как её исправить:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause 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и адрес доставки событий сохраняются.
Как настроить
- 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.
- 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.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- 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.
- 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 после дневного лимита, и тот же токен продолжит работать.
Работает для Claude, ChatGPT или вашей платформы. US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли подключение TikTok API работать бесконечно без владельца?
Нет. Продление поддерживает его самое большее в течение года действия токена обновления; после этого документированный путь TikTok это новая авторизация владельцем аккаунта.
Почему подключения TikTok сразу у нескольких аккаунтов перестали работать?
Сначала посмотрите на приложение, а не на аккаунты: код 40113 означает, что приложение заблокировано или его ID и секрет не совпадают, а TikTok может отозвать доступ приложения к Accounts API за злоупотребления.
Требует ли новая функция переподключения аккаунтов TikTok?
Да, если ей нужно разрешение (scope), которое владелец никогда не выдавал. Токен сохраняет разрешения, одобренные при авторизации, поэтому владельцу нужно снова авторизовать приложение, чтобы добавить новое.
Что происходит с запланированными публикациями TikTok, пока аккаунту нужно переподключение?
В easyCoexistence они в свой срок завершаются со статусом reconnect, не доходя до TikTok, владельцу приходит письмо, а Retry отправляет их, как только аккаунт снова подключён.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на