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

Токены доступа TikTok API for Business: 24 часа, обновление и отзыв

Токен доступа TikTok API for Business действует 24 часа и передаётся в заголовке Access-Token. Приложение получает его, обменяв код авторизации владельца в /tt_user/oauth2/token/, вместе с токеном обновления, который действует год и продлевает доступ через /tt_user/oauth2/refresh_token/. Отозвать токен можно в /tt_user/oauth2/revoke/, а список выданных разрешений посмотреть в /tt_user/token_info/get/.

easyCoexistence обменивает код, когда аккаунт TikTok входит в систему, продлевает токен на 24 часа до истечения и проверяет аккаунт примерно каждые 6 часов, поэтому Claude, ChatGPT или ваш код обращаются к TikTok с действующим токеном, который get_social_credentials передаёт вашим скриптам.

24 hours

Срок действия токена доступа аккаунта TikTok; каждый ответ с токеном указывает оставшиеся секунды в expires_in.

1 year

Срок действия токена обновления, выданного вместе с ним; refresh_token_expires_in даёт оставшиеся секунды.

10 minutes

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

open_id

Идентификатор приложения для аккаунта, возвращается с каждым токеном и передаётся как business_id в вызовах Accounts API.

Bearer

Тип токена (token_type), который возвращает TikTok: любой, у кого есть токен, может обращаться к ресурсам аккаунта.

creator_id

ID аккаунта, который возвращает /tt_user/token_info/get/ вместе с областью действия токена; его можно использовать как business_id в вызовах Accounts API.

Как код авторизации попадает в ваше приложение?

Через URL авторизации владельца аккаунта TikTok. TikTok создаёт его для приложения разработчика в разделе My Apps, App Detail, Basic Information, когда у приложения есть разрешение TikTok Accounts. Владелец аккаунта открывает ссылку, проверяет разрешения и подтверждает их. Затем TikTok перенаправляет браузер на redirect URL приложения и добавляет auth_code, а также значение state, если оно было в URL авторизации. Код действителен 10 минут и только для одного обмена.

  • Redirect URL: абсолютный, начинается с https://, заканчивается на /, без строки запроса, якоря и порта, длиной от 10 до 512 символов.
  • До 10 redirect URL на приложение, один активен в каждый момент; активация одного создаёт собственный URL авторизации.
  • state: необязательное значение, которое TikTok возвращает при перенаправлении; TikTok рекомендует использовать его для защиты от CSRF.
  • disable_auto_auth=1: показывает страницу проверки владельцам, которые уже подтверждали те же разрешения; иначе TikTok перенаправляет их сразу.

Как обменять код на токены?

POST-запросом на /tt_user/oauth2/token/ с вашего сервера, в формате JSON. В client_id и client_secret передаются App ID и Secret из раздела My Apps, App Detail, Basic Information; grant_type равен authorization_code; auth_code: код из перенаправления; redirect_uri должен совпадать с TikTok account holder redirect URL, указанным в приложении.

Exchange the authorization code
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/token/' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<APP_ID>",
    "client_secret": "<APP_SECRET>",
    "grant_type": "authorization_code",
    "auth_code": "<AUTH_CODE>",
    "redirect_uri": "https://app.example.com/tiktok/callback/"
  }'

Что содержит ответ с токенами?

JSON-объект с полями code, message, request_id и data. Код 0 означает, что обмен прошёл успешно; в data находятся оба токена и ID аккаунта:

  • access_token: краткосрочный токен для вызовов API, действует один день.
  • token_type: Bearer, по описанию TikTok, может использоваться любым, у кого есть токен.
  • scope: разрешения, выданные токену, одной строкой через запятую.
  • expires_in: секунды до истечения токена доступа, в примере TikTok 86400.
  • refresh_token: токен, который продлевает доступ и действует один год; TikTok рекомендует его сохранять.
  • refresh_token_expires_in: секунды до истечения токена обновления.
  • open_id: ID аккаунта TikTok в рамках приложения.
A token response (scope shortened)
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "access_token": "<ACCESS_TOKEN>",
    "token_type": "Bearer",
    "scope": "user.info.basic,user.info.stats,user.insights,video.list,video.insights,video.publish,comment.list,comment.list.manage",
    "expires_in": 86400,
    "refresh_token": "<REFRESH_TOKEN>",
    "refresh_token_expires_in": 31536000,
    "open_id": "<OPEN_ID>"
  }
}

Как токен передаётся в вызовах API?

В заголовке запроса Access-Token, на эндпоинтах Accounts API от /business/get/ до /business/video/publish/. Сам аккаунт указывается в business_id, в него подставляется open_id из того же ответа. Эндпоинты OAuth работают наоборот: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ и /tt_user/oauth2/revoke/ принимают client_id и client_secret приложения в теле JSON и не используют заголовок Access-Token.

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

POST-запросом на /tt_user/oauth2/refresh_token/, в котором переданы client_id, client_secret, grant_type со значением refresh_token и сохранённый refresh_token. Ответ содержит те же поля, что и первый обмен: новый access_token с его expires_in, refresh_token для следующего продления и оставшиеся секунды его срока. Продлевайте токен заранее, до истечения 24 часов, а не дожидаясь ошибки 40102.

Renew a TikTok account access token in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"

def renew(refresh_token: str) -> dict:
    r = requests.post(f"{API}/tt_user/oauth2/refresh_token/", json={
        "client_id": os.environ["TIKTOK_APP_ID"],
        "client_secret": os.environ["TIKTOK_APP_SECRET"],
        "grant_type": "refresh_token",
        "refresh_token": refresh_token,
    }, timeout=30).json()
    if r["code"] != 0:  # 40103: the refresh token expired, so the owner authorizes again
        raise RuntimeError(f"{r['code']}: {r['message']}")
    d, now = r["data"], time.time()
    return {
        "access_token": d["access_token"],
        "access_expires_at": now + d["expires_in"],
        "refresh_token": d["refresh_token"],  # keep it for the next renewal
        "refresh_expires_at": now + d["refresh_token_expires_in"],
    }

Как отозвать доступ?

Из приложения: POST-запросом на /tt_user/oauth2/revoke/ с client_id, client_secret и access_token, который нужно отозвать. Успех возвращает code 0 и пустой объект data. Со стороны аккаунта владелец открывает приложение TikTok, переходит в Settings and privacy, Security, Manage app permissions, выбирает приложение и нажимает Remove access. После отзыва TikTok перестаёт отправлять приложению события comment.update для этого аккаунта.

Revoke a TikTok account access token
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/revoke/' \
  -H 'Content-Type: application/json' \
  -d '{"client_id": "<APP_ID>", "client_secret": "<APP_SECRET>", "access_token": "<ACCESS_TOKEN>"}'

# {"code": 0, "message": "OK", "request_id": "<REQUEST_ID>", "data": {}}

Как проверить токен?

POST-запросом на /tt_user/token_info/get/, для которого не нужно отдельного разрешения: передайте app_id и access_token, в ответе data вернутся app_id, scope и creator_id. scope перечисляет разрешения, которые выдал владелец, а creator_id является ID аккаунта в рамках приложения, тем самым значением, которое Accounts API принимает как business_id. Документация TikTok направляет разработчиков сюда каждый раз, когда поле требует область действия, которой у токена может не быть.

Какие ошибки связаны с токенами?

TikTok возвращает их в поле code ответа, обычно при HTTP-статусе 200, поэтому проверяйте code, прежде чем считать вызов успешным. Коды возврата, связанные с токенами и их обменом:

  • 40102: срок токена доступа истёк; продлите его и повторите вызов.
  • 40103: срок токена обновления истёк; заменить его может только новая авторизация владельцем.
  • 40104: в запросе не передан токен доступа.
  • 40105: токен доступа недействителен или неверен.
  • 40107: токен обновления недействителен или неверен, например, отправлен для продления токена Marketing API, который не истекает.
  • 40110: код авторизации отменён, уже использован или истёк.
  • 40131: ошибка аутентификации на обоих эндпоинтах токенов: неверный ID или секрет приложения, истёкший код или недействительный либо истёкший токен обновления.

Что easyCoexistence продлевает за вас?

Всё, что идёт после входа. easyCoexistence обменивает код сразу, как TikTok перенаправляет обратно, сохраняет оба токена в зашифрованном виде и сам продлевает токен доступа: перед вызовом, если осталось меньше 15 минут, а также во время проверки, которую он выполняет примерно каждые 6 часов для каждого аккаунта, если осталось меньше 8 часов. Каждое продление сохраняет новый токен обновления и его срок; вызовы, пришедшие одновременно, используют одно продление.

  • Отклонённый токен: когда TikTok отвечает 40102, 40104 или 40105, подключение помечается для переподключения, а владелец получает письмо; пользователи Partner API также получают channel.disconnected.
  • Ваш код: get_social_credentials или GET /channels/{id}?credentials=1 в Partner API возвращает текущий токен с token_expires_at, поэтому получайте его перед каждой задачей.
  • Удаление: удаление подключения в панели управления или через DELETE /channels/{id} отзывает токен в TikTok через /tt_user/oauth2/revoke/.

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

  • Обмен кода авторизации в браузере. Обмен передаёт client_secret приложения, поэтому выполняйте его на сервере, в течение 10 минут после перенаправления.
  • Чтение expires_in как даты. Это количество оставшихся секунд, поэтому прибавьте его к времени ответа, чтобы узнать, когда токен истечёт.
  • Отзыв токеном обновления. /tt_user/oauth2/revoke/ принимает access_token вместе с client_id и client_secret приложения.
  • Принятие отсутствия экрана согласия за ошибку. TikTok пропускает страницу проверки для разрешений, которые владелец уже подтвердил; добавьте disable_auto_auth=1, чтобы показать её снова.
Настройка с EasyCoexistence

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

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

Сколько действует токен доступа TikTok API for Business?

24 часа. Каждый ответ с токеном сообщает оставшиеся секунды в expires_in, а токен обновления, действующий год, продлевает его.

Нужен ли redirect_uri для продления токена TikTok?

В таблице параметров эндпоинта указаны client_id, client_secret, grant_type и refresh_token, без redirect_uri. Однако руководство TikTok по аутентификации требует redirect_uri для эндпоинтов токенов.

Останавливает ли отзыв токена TikTok вебхуки?

Да. TikTok больше не отправляет приложению события comment.update для этого аккаунта, пока владелец снова не авторизует приложение.

Откуда берётся business_id в TikTok?

Из open_id в ответе с токенами; вызовы Accounts API принимают его как business_id. /tt_user/token_info/get/ возвращает тот же ID как creator_id.

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

Scope в TikTok API for Business: что открывает каждое разрешениеРазрешения API TikTok Accounts по именам TikTok: что открывает каждое, scope токена для полей и как проверить токен.Ошибка TikTok 40102: срок действия токена доступа истёкОшибка TikTok 40102 значит, что токен доступа истёк. Токен живёт один день: как обновить его через refresh-токен и когда нужно переподключиться.Ошибка TikTok 40103: срок действия refresh-токена истёкОшибка TikTok 40103: истёк срок refresh-токена, и доступ нельзя продлить. Refresh-токены Accounts API действуют один год. Решение: новая авторизация.TikTok API for Business против Content Posting APIПочему API for Business от TikTok, а не developers.tiktok.com: комментарии и их вебхук, инсайты, какие аккаунты подключаются и как обновляются токены.Настройка вебхуков TikTok API for BusinessКак подписать приложение TikTok API for Business на вебхуки: /business/webhook/update/, события VIDEO и COMMENT, правила callback и Tiktok-Signature.Как опубликовать видео в TikTok через APIПубликуйте видео в TikTok через API for Business: эндпоинт публикации, тело JSON, share_id из ответа и проверка статуса в curl и Python.

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

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

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

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