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

Ошибка 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 или вашего кода.

40104

Код возврата TikTok, когда токен доступа пуст; исправление: отправить действующий токен.

Access-Token

Обязательный заголовок, который передаёт токен аккаунта TikTok в эндпоинтах Accounts API.

business_id

Параметр, который указывает аккаунт TikTok в каждом вызове; задаётся равным open_id, возвращённому вместе с токеном.

Bearer

token_type, который TikTok возвращает для токена доступа аккаунта TikTok; его по-прежнему передают в Access-Token.

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

TikTok получил вызов без токена доступа. В приложении с кодами возврата 40104 описан как пустой токен доступа, и исправление то же, что для других ошибок токена: использовать действующий токен доступа и повторить попытку. Запрос дошёл до TikTok, но в нём не было указано, по какой авторизации он выполняется, поэтому TikTok считает вызов неуспешным.

Куда передаётся токен?

В заголовок с именем Access-Token. В справочниках Accounts API, от публикации до комментариев и аналитики, Access-Token указан как обязательный заголовок с токеном, который авторизовал аккаунт TikTok. Сам аккаунт указывается отдельно, в business_id, равным open_id, полученному вместе с токеном.

An Accounts API call with its token
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 так же и получает тот же код.
Настройка с EasyCoexistence

Если 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 передаёт авторизацию действовать от его имени. Нужны оба параметра в каждом вызове.

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

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

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

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

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

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