Ошибка TikTok 40104: токен доступа пуст
Ошибка TikTok 40104 означает, что запрос пришёл без токена доступа. Эндпоинты Accounts API, например /business/video/list/ и /business/comment/list/, ожидают токен аккаунта TikTok в заголовке запроса с именем Access-Token. Добавьте этот заголовок с действующим токеном, полученным через /tt_user/oauth2/token/ или обновлённым с помощью refresh token, и отправьте запрос снова.
easyCoexistence добавляет текущий токен аккаунта TikTok в заголовок Access-Token к каждому вызову, который делает для Claude, ChatGPT или вашего кода.
Код возврата TikTok, когда токен доступа пуст; исправление: отправить действующий токен.
Обязательный заголовок, который передаёт токен аккаунта TikTok в эндпоинтах Accounts API.
Параметр, который указывает аккаунт TikTok в каждом вызове; задаётся равным open_id, возвращённому вместе с токеном.
token_type, который TikTok возвращает для токена доступа аккаунта TikTok; его по-прежнему передают в Access-Token.
Что означает ошибка 40104?
TikTok получил вызов без токена доступа. В приложении с кодами возврата 40104 описан как пустой токен доступа, и исправление то же, что для других ошибок токена: использовать действующий токен доступа и повторить попытку. Запрос дошёл до TikTok, но в нём не было указано, по какой авторизации он выполняется, поэтому TikTok считает вызов неуспешным.
Куда передаётся токен?
В заголовок с именем Access-Token. В справочниках Accounts API, от публикации до комментариев и аналитики, Access-Token указан как обязательный заголовок с токеном, который авторизовал аккаунт TikTok. Сам аккаунт указывается отдельно, в business_id, равным open_id, полученному вместе с токеном.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","caption","video_views"]'Как заголовок оказывается пустым?
Токен теряется между хранилищем и запросом. Проверьте следующие места:
- Заголовок называется иначе. Токен, отправленный как Authorization: Bearer, оставляет Access-Token пустым, хотя TikTok указывает тип токена как Bearer.
- Переменная с токеном пуста, например после неудачного обновления, ошибка которого не была проверена.
- Токен передаётся в теле запроса или в строке запроса, а не в заголовке.
- Вспомогательная функция, написанная для /
tt_user/oauth2/token/ и /tt_user/oauth2/refresh_token/, используется повторно; эти эндпоинты не принимают заголовок Access-Token, поэтому функция его не отправляет.
Как это исправить?
Передайте токен в Access-Token вместе с business_id. Если текущего токена нет, получите его: обновите через /tt_user/oauth2/refresh_token/, пока refresh token действителен, либо попросите владельца аккаунта заново авторизовать приложение, если refresh token не действует. При отладке записывайте в лог, присутствует ли заголовок и какова длина его значения, а не сам токен, поскольку TikTok предупреждает, что любой, у кого есть токен, может им воспользоваться.
Распространённые ошибки
- Принимать 40104 за истёкший токен. Токен отсутствует, а не устарел, поэтому его обновление ничего не меняет, пока код действительно не отправляет токен.
- Обновлять токен, не передавая новый дальше. Обновление возвращает новый токен доступа, и последующие вызовы должны передавать это значение в Access-Token.
- Повторять запрос без изменений. Без заголовка каждая попытка доходит до TikTok так же и получает тот же код.
Если TikTok всё равно отвечает 40102, 40104 или 40105, подключение сразу помечается для повторного подключения, и вы получаете письмо. От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Можно ли передавать токен TikTok как Authorization: Bearer?
Нет. Эндпоинты Accounts API читают токен из заголовка Access-Token, поэтому токен, отправленный как Authorization: Bearer, оставляет его пустым, и вызов возвращает 40104, хотя TikTok указывает тип токена как Bearer.
Означает ли 40104 то же, что истёкший токен?
Нет. 40104 означает, что токен вообще не пришёл; истёкший возвращает 40102, а недействительный или неверный возвращает 40105.
Нужен ли Access-Token эндпоинтам токенов TikTok?
Нет. /tt_user/oauth2/token/ и /tt_user/oauth2/refresh_token/ определяют приложение по client_id и client_secret в теле запроса.
Заменяет ли business_id токен?
Нет. business_id указывает, к какому аккаунту TikTok относится вызов, а Access-Token передаёт авторизацию действовать от его имени. Нужны оба параметра в каждом вызове.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на