Scope в TikTok API for Business: что открывает каждое разрешение
API for Business у TikTok даёт доступ на двух уровнях. Приложение разработчика получает разрешения в TikTok Accounts, например Video Publish и Manage Account Comment, которые открывают эндпоинты. Авторизация владельца аккаунта выдаёт токену доступа scope, например user.insights и video.list, которые определяют возвращаемые поля. /tt_user/token_info/get/ перечисляет scope, которые несёт токен.
easyCoexistence запрашивает у владельца аккаунта TikTok разрешения, которые держит его приложение, одним входом, поэтому Claude, ChatGPT или ваш собственный код могут публиковать, работать с комментариями и читать аналитику через его инструменты, а get_social_credentials даёт вашему коду тот же токен для других эндпоинтов Accounts API.
Scope ID для TikTok Accounts: разрешение первого уровня над эндпоинтами Accounts API для профиля, постов, комментариев и публикации.
Scope, за которым стоят is_business_account и has_advanced_access в данных профиля аккаунта.
Scope, который владелец должен выдать и сохранять активным, чтобы приложение получало вебхуки comment.update.
Scope, нужный токену, чтобы загружать пост как черновик, а не публиковать его.
Рабочие дни, которые может занимать проверка TikTok изменения разрешений приложения разработчика.
Какие бывают два уровня разрешений TikTok?
Разрешения приложения и scope токена. Разрешения приложения выбираются в «My Apps», в приложении, в разделе «Scope of permission», и TikTok их проверяет; они бывают трёх уровней, и разрешение первого уровня покрывает все эндпоинты ниже. Scope токена представляет собой то, что владелец аккаунта одобрил при авторизации приложения; они возвращаются в поле scope одной строкой через запятую, с каждым токеном. Вызову нужно разрешение приложения для его эндпоинта, а некоторым полям ответа также нужен scope на токене.
Какое разрешение приложения открывает каждый эндпоинт?
Справочник API TikTok для каждого эндпоинта Accounts API указывает разрешение в TikTok Accounts, которое его открывает, либо разрешения нет. Справочник по scope разрешений и руководство по вебхукам называют те же группы Business User, Business Media, Business Comment и Business Content, поэтому ожидайте оба набора названий:
Какие scope токена открывают какие поля?
Справочники TikTok по /business/get/ и /business/video/list/ указывают обязательное разрешение для каждого поля ответа, а две другие функции имеют собственный scope:
- user.info.basic:
display_nameиprofile_image. - user.info.username: username, которому до июня 2023 года требовался user.info.basic.
- user.info.profile:
profile_deep_link,bio_descriptionиis_verified. - user.info.stats:
following_count,followers_count,total_likesиvideos_count. - user.account.type:
is_business_accountиhas_advanced_access. - user.insights: ежедневные метрики аккаунта и разбивка подписчиков по возрасту, полу, стране и городу.
- video.list: поля постов, например
item_id, caption,share_url, likes, comments, shares, reach иvideo_views. - video.insights: время просмотра, долю полного просмотра, удержание, источники трафика, разбивку зрителей и клики, которые приносит пост.
- comment.list: вебхук comment.update, который TikTok описывает как чтение комментариев и ответов на контент в приложении.
- video.upload: загрузка видео- или фотопоста как черновика, с
upload_to_draftилиis_draft.
Как посмотреть scope токена?
Запросите /tt_user/token_info/get/, который принимает app_id и токен доступа и возвращает scope токена и creator_id аккаунта. Примеры строк scope у TikTok также включают video.publish и comment.list.manage, чьи названия совпадают с эндпоинтами публикации и управления комментариями, хотя справочники TikTok не связывают с ними ни одного поля.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}Что запрашивает подключение easyCoexistence к TikTok?
Все разрешения, которые держит его приложение разработчика, и все они показываются на странице согласия TikTok. easyCoexistence отправляет владельца аккаунта на URL авторизации держателя аккаунта TikTok, который генерирует портал TikTok для его приложения, который уже называет эти разрешения, и добавляет только собственное значение state. Владелец одобряет то, что показывает TikTok, а строка scope, которую возвращает TikTok, сохраняется вместе с подключением. Эндпоинты, которые easyCoexistence затем вызывает для аккаунта:
- /business/get/ для профиля, ежедневных метрик и разбивки подписчиков.
- /business/video/list/ для постов и их метрик.
- /business/video/publish/, /business/photo/publish/ и /business/publish/status/ для публикации.
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ и /business/comment/delete/ для комментариев.
- /business/webhook/update/ на уровне приложения для вебхука комментариев.
Как добавить разрешение позже?
В два шага, по одному на каждый уровень. Для приложения откройте «My Apps», приложение, «Scope of permission», измените его, укажите причину, соответствующую новым scope, и отправьте на проверку. Проверка TikTok может занять два–три рабочих дня, а с 20 марта 2026 г. запрос, включающий TikTok Accounts, сначала требует Accounts API Access Application Form. Для токена владелец авторизует приложение заново, так как токен сохраняет scope, одобренные при его выдаче.
Что происходит, когда разрешения нет?
Для вызова код ошибки TikTok 40001 означает, что нет разрешения на выполнение связанной операции, а исправление ссылается на справочник scope разрешений. Для поля справочники делают его доступным только после того, как владелец выдал его scope, и исправление состоит в том, чтобы владелец авторизовал приложение заново с этим scope. Проверьте scope токена через /tt_user/token_info/get/, прежде чем просить об этом владельца.
Распространённые ошибки
- Ожидание, что подключённые аккаунты сами получат новое разрешение приложения. Их токены сохраняют scope, одобренные при авторизации, пока каждый владелец не авторизует приложение заново.
- Запрос is_business_account без user.account.type. TikTok делает это поле и has_advanced_access доступными только токенам, которые несут этот scope.
- Ожидание comment.update без comment.list. TikTok присылает события комментариев только пока авторизация владельца с этим scope остаётся действительной.
- Поиск названий разрешений приложения в токене. Строка scope использует названия вроде video.list, а названия вроде Get Account Media относятся к настройкам приложения.
Цена от US$ 9 до US$ 0,75 за подключение в месяц, дешевеет по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Какие scope использует TikTok API for Business?
Scope токена, такие как user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list и video.upload, которые выдаёт владелец аккаунта поверх разрешений TikTok Accounts приложения.
Какие разрешения нужны вебхуку комментариев TikTok?
Приложению нужны TikTok Accounts и Business Comment, а владелец должен выдать comment.list. События прекращаются, если эта авторизация истекает или отзывается.
Применяется ли новый scope TikTok к уже выданным токенам?
Нет. Токен сохраняет scope, одобренные при его выдаче, поэтому владелец аккаунта авторизует приложение заново, чтобы добавить новый.
Сколько времени TikTok одобряет новое разрешение?
TikTok говорит, что проверка изменения разрешения может занять два–три рабочих дня, а запросы, добавляющие TikTok Accounts, сначала требуют Accounts API Access Application Form.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на