Медиа-ссылки 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 его загружает, поэтому ваш домен не нужно подтверждать.
С тех пор TikTok отклоняет URL видео, которые не находятся на подтверждённом домене или префиксе URL.
С тех пор эндпоинты свойств URL также требуют секрет приложения разработчика.
Значения property_type: 1 для домена, 2 для префикса URL.
Значения property_status: pending, verified и not verified, последнее означает, что попытка не удалась и её нужно повторить.
Разработчикам, которые публиковали видео раньше, домены URL их видео были автоматически помечены как «подтверждённые».
Максимальный размер изображения, принимаемого /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 для каждого типа объекта:
| Domain | URL prefix | |
|---|---|---|
| What it is | A site you own, such as example.com or a subdomain | https:// plus a host, a path and a final /, such as https://www.example.com/videos/ |
| Proof | A DNS TXT record holding the signature | A file named file_name, holding the signature, uploaded under the prefix |
| Covers | URLs on the domain and its subdomains | URLs that begin with the prefix |
| Leaves out | The parent: verifying video.example.com leaves example.com unverified | Sibling paths: /folder/user/ leaves /folder/public/ unverified |
| Redirects | Not applicable | Not followed; a prefix answering 3xx is invalid |
Как подтвердить объект?
В два вызова, которые аутентифицируются через app_id и secret приложения разработчика, а не токеном аккаунта, с доказательством между ними:
- Добавить: POST /business/property/add/ с
url_property_meta, содержащимproperty_typeи url; ответ возвращает signature, а для префикса такжеfile_name, сproperty_status0. - Доказать: поместите подпись в запись DNS TXT для домена или в публичный файл с именем
file_nameи единственным расширением .txt под префиксом. - Проверить: POST /business/property/verify/ с тем же
url_property_meta;property_status1 означает подтверждено, 2 означает, что попытка не удалась.
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 видео, для которого подтверждение не нужно:
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 не может загрузить файл, и публикация завершается ошибкой.
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 загружает его позже, в течение часа, и завершает публикацию с ошибкой, если ссылка перестала работать.
От 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 фото.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на