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

Медиа-ссылки TikTok: проверенные домены и префиксы URL

API for Business у TikTok загружает медиа по URL: video_url, custom_thumbnail_url и photo_images. Каждый URL должен находиться на домене или префиксе URL, владение которым подтверждено в приложении разработчика. Домен подтверждается записью DNS TXT, префикс файлом подписи, размещённым под ним, через /business/property/add/ и /business/property/verify/ с app_id и секретом приложения.

easyCoexistence отдаёт ваши медиа в TikTok из собственного подтверждённого префикса URL: publish_tiktok_post принимает ссылку HTTPS от Claude, ChatGPT или вашего кода и передаёт файл по ней, когда TikTok его загружает, поэтому ваш домен не нужно подтверждать.

Nov 16, 2023

С тех пор TikTok отклоняет URL видео, которые не находятся на подтверждённом домене или префиксе URL.

Oct 15, 2025

С тех пор эндпоинты свойств URL также требуют секрет приложения разработчика.

1 / 2

Значения property_type: 1 для домена, 2 для префикса URL.

0, 1, 2

Значения property_status: pending, verified и not verified, последнее означает, что попытка не удалась и её нужно повторить.

Apr 7, 2023

Разработчикам, которые публиковали видео раньше, домены URL их видео были автоматически помечены как «подтверждённые».

5 MB

Максимальный размер изображения, принимаемого /business/comment/image/upload/ как multipart form data для комментария или ответа.

Какие URL скачивает TikTok?

Каждое поле медиа в двух эндпоинтах публикации это URL, который TikTok сам загружает после принятия вызова, поэтому файл должен оставаться доступным до окончания загрузки:

  • video_url: видео, которое TikTok рекомендует держать действительным не менее 30 минут.
  • custom_thumbnail_url: изображение, которое используется как обложка видео.
  • photo_images: до 35 изображений для фотопубликации.
  • Тайм-аут: TikTok даёт загрузке один час, после чего завершает публикацию с ошибкой video_pull_failed или photo_pull_failed.

В чём разница между доменом и префиксом URL?

Что вы подтверждаете как своё, и, следовательно, какие URL считаются подтверждёнными. Домен подходит для медиа на хосте, которым вы владеете или управляете; префикс подходит для папки на хосте, куда вы можете только загружать файлы. Правила TikTok для каждого типа объекта:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

Как подтвердить объект?

В два вызова, которые аутентифицируются через app_id и secret приложения разработчика, а не токеном аккаунта, с доказательством между ними:

  • Добавить: POST /business/property/add/ с url_property_meta, содержащим property_type и url; ответ возвращает signature, а для префикса также file_name, с property_status 0.
  • Доказать: поместите подпись в запись DNS TXT для домена или в публичный файл с именем file_name и единственным расширением .txt под префиксом.
  • Проверить: POST /business/property/verify/ с тем же url_property_meta; property_status 1 означает подтверждено, 2 означает, что попытка не удалась.
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

Как посмотреть или удалить объекты?

GET /business/property/list/ с app_id и secret возвращает url_property_info_list, где каждая запись содержит property_type, url, property_status, signature и file_name. Поддомены подтверждённого домена считаются подтверждёнными без собственного вызова, но появляются в списке, только если были добавлены. POST /business/property/delete/ с app_id, secret и url_property_meta удаляет объект, которым приложение больше не владеет и не управляет.

Можно загрузить файл вместо URL?

Для публикаций нет. Accounts API публикует только по URL, включая черновики, а его единственный эндпоинт загрузки, /business/comment/image/upload/, принимает изображение комментария как multipart form data в форматах JPG, JPEG, WebP или PNG размером до 5 МБ и возвращает image_uri для комментария или ответа. Загрузка файла по частям относится к Content Posting API на developers.tiktok.com, отдельному API со своими приложениями, где способ передачи называется FILE_UPLOAD.

Что происходит с непроверенным URL?

TikTok отказывается публиковать из него. В справочнике API for Business это правило сформулировано для видео и фото, но собственного кода возврата для него не указано, поэтому смотрите код и сообщение в ответе. Content Posting API на developers.tiktok.com называет тот же случай url_ownership_unverified с HTTP 403. Чтобы проверить эндпоинт видео до подтверждения любого объекта, TikTok предоставляет тестовый URL видео, для которого подтверждение не нужно:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

Как easyCoexistence доставляет ваши медиа в TikTok?

Через один собственный подтверждённый префикс URL: https://easycoexistence.com/api/social/media/. publish_tiktok_post принимает вашу ссылку HTTPS, отклоняет http:// до отправки чего-либо и передаёт TikTok ссылку под этим префиксом с подписанным токеном, который называет ваш файл, истекает через 6 часов и сохраняет расширение файла. Когда TikTok её загружает, easyCoexistence проверяет токен, подтверждает, что ваша ссылка использует HTTPS на публичном адресе, и передаёт файл напрямую из вашей ссылки, включая запросы Range и перенаправления, без сохранения. Если ваша ссылка не работает, TikTok не может загрузить файл, и публикация завершается ошибкой.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

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

  • Подтверждение поддомена при размещении файлов на его родительском домене. Подтверждённый video.example.com покрывает свои поддомены, но не сам example.com.
  • Отдача файла подписи префикса через перенаправление. TikTok не следует перенаправлениям для префикса URL и считает ответ 3xx недействительным.
  • Сохранение файла подписи как name.txt.txt. TikTok требует, чтобы имя файла совпадало с file_name и имело одно расширение .txt.
  • Удаление файла сразу после вызова публикации. TikTok загружает его позже, в течение часа, и завершает публикацию с ошибкой, если ссылка перестала работать.
Настройка с EasyCoexistence

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

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

Почему TikTok требует подтверждённые URL медиа?

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

Покрывает ли подтверждённый домен TikTok его поддомены?

Да. Поддомены подтверждённого домена считаются подтверждёнными, хотя /business/property/list/ показывает их только если они были добавлены.

Может ли API for Business у TikTok публиковать по ссылке S3 или CDN?

Да, если ссылка находится под доменом или префиксом URL, подтверждённым приложением, например под префиксом на бакете или пути CDN, которым вы управляете.

Нужны ли подтверждённые URL и для фотопубликаций?

Да. Эндпоинт фото TikTok указывает, что фотопубликации нельзя публиковать из непроверенных URL фото.

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

Как опубликовать видео в TikTok через APIПубликуйте видео в TikTok через API for Business: эндпоинт публикации, тело JSON, share_id из ответа и проверка статуса в curl и Python.Настройки публикации TikTok через API: приватность, комментарии, Duet и StitchНастройки, которые принимают эндпоинты публикации TikTok: приватность, комментарии, Duet, Stitch, обложка, маркировки и допустимые значения аккаунта.Требования к видео для TikTok API: формат, размер и длинаВидео для API for Business от TikTok: MP4, MOV или WebM, от 3 до 600 секунд, до 1 ГБ, 23–60 FPS, по URL, который TikTok загружает сам.Фото-посты и карусели TikTok через API: до 35 изображенийФото-посты TikTok через API: от 1 до 35 изображений JPEG или WebP до 20 МБ каждое, заголовок до 90 символов, подпись и обложка.Маркировка контента, созданного ИИ, в TikTok через APIКак пометить видео, созданное ИИ, через API TikTok for Business с помощью post_info.is_ai_generated и что требует политика TikTok.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.

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

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

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

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