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

Как проверить статус публикации поста TikTok через API

TikTok публикует посты через API асинхронно: вызов публикации возвращает share_id, а GET /business/publish/status/ с этим ID в качестве publish_id показывает, на каком этапе находится пост. Статус PROCESSING_DOWNLOAD показывает, что TikTok загружает файл. PUBLISH_COMPLETE означает, что пост прошёл модерацию и опубликован. FAILED сообщает об остановке публикации с причиной, например frame_rate_check_failed.

easyCoexistence публикует в TikTok через publish_tiktok_post и отслеживает каждый пост с помощью get_tiktok_publish_status из Claude, ChatGPT или вашего собственного кода, так что ваш ИИ видит статус TikTok и причину сбоя в актуальном виде.

3 min

Сколько времени ID постов могут появляться после PUBLISH_COMPLETE: TikTok советует повторить запрос через три минуты, если их нет.

30 min

Оценка TikTok на загрузку файла поста размером 1 ГБ; реальное время зависит от размера файла и сети.

2 min

Обычное максимальное ожидание после завершения загрузки до публичного показа поста; ручная модерация может занять больше времени.

1 hour

Тайм-аут загрузки, после которого TikTok завершает пост с ошибкой video_pull_failed или photo_pull_failed.

Зачем нужно отслеживать пост TikTok?

Потому что TikTok публикует его в фоновом режиме. Вызов публикации запускает задачу и сразу возвращает share_id; затем TikTok загружает файл по URL, проверяет формат, проводит модерацию и делает пост публичным. Пост может завершиться сбоем, даже если сам вызов прошёл успешно.

Какие есть статусы?

GET /business/publish/status/ принимает business_id аккаунта и share_id как publish_id и возвращает один из четырёх статусов:

  • PROCESSING_DOWNLOAD: TikTok загружает контент по его URL.
  • PUBLISH_COMPLETE: пост прошёл модерацию и опубликован; post_ids содержит его ID, когда пост становится публично доступен.
  • FAILED: публикация остановлена, а reason объясняет причину.
  • SEND_TO_USER_INBOX: черновик загружен, и TikTok уведомил входящие автора; применяется только к черновикам.

Сколько длится публикация?

TikTok не указывает фиксированного времени. Загрузка зависит от размера файла и сети; по общей оценке TikTok, для файла 1 ГБ достаточно 30 минут, а предел составляет час. Затем пост обычно становится публичным в течение 2 минут или позже, если требуется ручная модерация, а его ID может появиться в статусе ещё через три минуты.

Что означают причины сбоя?

reason называет то, что остановило пост. Одни требуют изменить файл, другие допускают повторную попытку:

  • file_format_check_failed, duration_check_failed, frame_rate_check_failed, picture_size_check_failed: файл нарушает правило формата; TikTok помечает эти ошибки как не подлежащие повтору.
  • video_pull_failed, photo_pull_failed: TikTok не смог загрузить файл или не уложился в час; повторите попытку, когда URL станет публично доступен.
  • internal: часть сервиса TikTok была недоступна, повторная попытка допустима.
  • spam_risk_too_many_posts, spam_risk, spam_risk_text: TikTok остановил пост из-за объёма, поведения или содержания подписи.
  • auth_removed: аккаунт отозвал доступ приложения во время обработки; TikTok советует не повторять попытку.
  • spam_risk_user_banned_from_posting: аккаунту запрещено создавать новые посты.

Для чего нужен ID поста?

Чтобы найти пост позже. Справочник TikTok передаёт ID постов в /business/video/list/ через filters.video_ids, чтобы получить метрики постов. Вызовы комментариев, в свою очередь, принимают item_id поста из списка видео аккаунта как video_id, и именно его инструменты комментариев easyCoexistence принимают как post_id.

Как easyCoexistence отслеживает пост?

publish_tiktok_post возвращает share_id TikTok и сообщение о том, что TikTok обрабатывает пост, а get_tiktok_publish_status принимает этот share_id и возвращает текущий статус TikTok с причиной, если она есть. Попросите ваш ИИ-ассистент проверить статус через несколько минут, а не сразу.

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

  • Повторная публикация, потому что ничего не появилось. Первый вызов лишь запустил задачу, поэтому проверьте её статус, прежде чем отправлять пост повторно.
  • Принятие PUBLISH_COMPLETE без post_ids за ошибку. ID могут появиться ещё на три минуты позже, поэтому проверьте снова тогда.
  • Повторная попытка при сбое формата с тем же файлом. file_format_check_failed и другие сбои проверок требуют исправленного файла.
  • Отключение URL во время загрузки. TikTok завершает пост с ошибкой video_pull_failed или photo_pull_failed, если не может получить файл.
Настройка с EasyCoexistence

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

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

Что такое share_id в TikTok?

ID задачи публикации, который возвращают эндпоинты публикации видео и фото. В запросе статуса он передаётся как publish_id.

Есть ли вебхук для статуса публикации в TikTok?

Да. Приложение, подписанное с event_type VIDEO через /business/webhook/update/, получает события публикации постов TikTok, например post.publish.failed с причиной и publish_id, вместо повторных проверок статуса.

Почему у опубликованного поста пока нет ID?

TikTok может потратить до трёх минут после PUBLISH_COMPLETE, прежде чем вернёт post_ids, и возвращает их только для публично доступных постов.

Можно ли повторить публикацию неудачного поста TikTok?

Зависит от причины. Сбои загрузки и внутренние сбои можно повторить; сбои формата, длительности, частоты кадров и размера изображения требуют исправленного файла.

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

Требования к видео для TikTok API: формат, размер и длинаВидео для API for Business от TikTok: MP4, MOV или WebM, от 3 до 600 секунд, до 1 ГБ, 23–60 FPS, по URL, который TikTok загружает сам.Лимиты публикаций TikTok API: сколько постов в деньСколько постов TikTok API публикует с одного аккаунта: шесть в минуту и 15 в день для эндпоинтов видео и фото, и что происходит сверх лимита.Планирование публикаций в TikTok через APIКак планируются видео и фотопубликации TikTok через API: очередь, которая публикует в заданные дату и время, с правилами TikTok на момент отправки.События вебхука комментариев TikTokКак вебхук comment.update от TikTok сообщает о комментариях и ответах, что несёт каждое событие и как оно приходит на ваш эндпоинт с подписью.API аналитики TikTok: показатели аккаунта и видеоМетрики TikTok из API for Business: подписчики, просмотры и лайки по дням для аккаунта, просмотры, лайки, комментарии и репосты по видео.Ошибка TikTok 40007: объект не существуетОшибка TikTok 40007 означает, что запрос ссылается на объект, URL или файл, которого не существует. Какие ID Accounts API проверить и откуда каждый берётся.

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

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

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

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