Как проверить статус публикации поста 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 и причину сбоя в актуальном виде.
Сколько времени ID постов могут появляться после PUBLISH_COMPLETE: TikTok советует повторить запрос через три минуты, если их нет.
Оценка TikTok на загрузку файла поста размером 1 ГБ; реальное время зависит от размера файла и сети.
Обычное максимальное ожидание после завершения загрузки до публичного показа поста; ручная модерация может занять больше времени.
Тайм-аут загрузки, после которого 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, если не может получить файл.
От 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?
Зависит от причины. Сбои загрузки и внутренние сбои можно повторить; сбои формата, длительности, частоты кадров и размера изображения требуют исправленного файла.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на