Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Adresy URL multimediów TikTok: zweryfikowane domeny i prefiksy URL

API for Business TikToka pobiera media z adresów URL: video_url, custom_thumbnail_url i photo_images. Każdy adres URL musi znajdować się w domenie lub prefiksie URL, którego własność aplikacja dewelopera zweryfikowała. Domenę weryfikuje się rekordem DNS TXT, a prefiks plikiem podpisu umieszczonym pod nim, przez /business/property/add/ i /business/property/verify/ z ID aplikacji i sekretem.

easyCoexistence udostępnia Twoje multimedia TikTokowi z własnego, zweryfikowanego prefiksu URL: publish_tiktok_post przyjmuje link HTTPS od Claude, ChatGPT lub Twojego kodu i przesyła plik z niego, gdy TikTok go pobiera, więc Twoja domena nie wymaga weryfikacji.

Nov 16, 2023

Od tego momentu TikTok odrzuca adresy wideo, które nie znajdują się w zweryfikowanej domenie lub prefiksie URL.

Oct 15, 2025

Od tego momentu endpointy właściwości URL wymagają także sekretu aplikacji dewelopera.

1 / 2

Wartości property_type: 1 dla domeny, 2 dla prefiksu URL.

0, 1, 2

Wartości property_status: pending, verified oraz not verified, co oznacza, że próba się nie powiodła i trzeba ją powtórzyć.

Apr 7, 2023

Deweloperzy, którzy opublikowali wideo wcześniej, mieli domeny tych adresów wideo ustawione automatycznie na zweryfikowane.

5 MB

Największy obraz, jaki przyjmuje /business/comment/image/upload/ jako dane formularza multipart, dotyczy komentarza lub odpowiedzi.

Które adresy URL pobiera TikTok?

Każde pole multimediów w dwóch endpointach publikacji to adres URL, który TikTok sam pobiera po przyjęciu wywołania, dlatego plik musi pozostać dostępny do zakończenia pobierania:

  • video_url: wideo; TikTok zaleca, by adres był ważny co najmniej 30 minut.
  • custom_thumbnail_url: obraz użyty jako okładka wideo.
  • photo_images: do 35 obrazów dla posta ze zdjęciami.
  • Limit czasu: TikTok daje pobieraniu godzinę, po czym kończy post błędem video_pull_failed lub photo_pull_failed.

Czym różni się domena od prefiksu URL?

Zależy od tego, co udowodnisz, że posiadasz, a więc które adresy URL uznaje się za zweryfikowane. Domena pasuje do multimediów na hoście, który posiadasz lub kontrolujesz; prefiks pasuje do folderu na hoście, do którego możesz jedynie wysyłać pliki. Zasady TikToka dla każdego typu właściwości:

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

Jak zweryfikować właściwość?

Dwoma wywołaniami uwierzytelnianymi app_id i sekretem aplikacji dewelopera, zamiast tokenem konta, z dowodem umieszczonym między nimi:

  • Dodaj ją: POST /business/property/add/ z url_property_meta, zawierającym property_type i url; odpowiedź zwraca signature, a dla prefiksu także file_name, z property_status 0.
  • Udowodnij to: umieść podpis w rekordzie DNS TXT dla domeny albo w publicznym pliku o nazwie file_name, z pojedynczym rozszerzeniem .txt, pod prefiksem.
  • Sprawdź: POST /business/property/verify/ z tym samym url_property_meta; property_status 1 oznacza zweryfikowaną, a 2 oznacza, że próba się nie powiodła.
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

Jak wyświetlić listę lub usunąć właściwości?

GET /business/property/list/ z app_id i sekretem zwraca url_property_info_list, a każdy wpis zawiera property_type, url, property_status, signature i file_name. Subdomeny zweryfikowanej domeny liczą się jako zweryfikowane bez własnego wywołania, ale pojawiają się na liście tylko wtedy, gdy zostały dodane. POST /business/property/delete/ z app_id, sekretem i url_property_meta usuwa właściwość, której aplikacja nie posiada ani nie kontroluje.

Czy można przesłać plik zamiast adresu URL?

Nie w przypadku postów. Accounts API publikuje wyłącznie z adresów URL, także wersje robocze, a jedyny endpoint przesyłania, /business/comment/image/upload/, przyjmuje obraz komentarza jako dane formularza multipart w formatach JPG, JPEG, WebP lub PNG do 5 MB i zwraca image_uri dla komentarza lub odpowiedzi. Przesyłanie plików w częściach należy do Content Posting API na developers.tiktok.com, które ma własne aplikacje i w którym metoda transferu nazywa się FILE_UPLOAD.

Co się dzieje z niezweryfikowanym adresem URL?

TikTok odmawia publikacji z niego. Dokumentacja API for Business podaje regułę dla wideo i zdjęć, ale nie nazywa dla niej własnego kodu zwrotnego, więc odczytaj kod i komunikat w odpowiedzi. Content Posting API na developers.tiktok.com nazywa ten przypadek url_ownership_unverified, z kodem HTTP 403. Aby wypróbować endpoint wideo, zanim jakakolwiek właściwość zostanie zweryfikowana, TikTok udostępnia testowy adres URL wideo, który nie wymaga weryfikacji:

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

Jak easyCoexistence dostarcza Twoje multimedia do TikToka?

Przez jeden własny, zweryfikowany prefiks URL: https://easycoexistence.com/api/social/media/. publish_tiktok_post przyjmuje Twój link HTTPS, odrzuca http:// zanim cokolwiek zostanie wysłane i przekazuje TikTokowi link pod tym prefiksem, zawierający podpisany token, który wskazuje Twój plik, wygasa po 6 godzinach i zachowuje rozszerzenie pliku. Gdy TikTok go pobiera, easyCoexistence sprawdza token, potwierdza, że Twój link używa HTTPS na publicznym adresie, i przesyła plik strumieniowo bezpośrednio z Twojego linku, w tym żądania zakresów bajtów i przekierowania, bez jego przechowywania. Jeśli Twój link zawiedzie, TikTok nie może pobrać pliku i post kończy się błędem.

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

Typowe błędy

  • Zweryfikowanie subdomeny zamiast domeny nadrzędnej, gdy pliki są hostowane na domenie nadrzędnej. Zweryfikowana video.example.com obejmuje własne subdomeny, ale nie samo example.com.
  • Udostępnianie pliku podpisu prefiksu przez przekierowanie. TikTok nie podąża za przekierowaniami dla prefiksu URL i traktuje odpowiedź 3xx jako nieprawidłową.
  • Zapisanie pliku podpisu jako name.txt.txt. TikTok oczekuje, że nazwa pliku będzie zgodna z file_name, z pojedynczym rozszerzeniem .txt.
  • Usunięcie pliku zaraz po wywołaniu publikacji. TikTok pobiera go później, przez do godziny, i kończy post błędem, jeśli link przestanie działać.
Z EasyCoexistence zrobisz to

US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Dlaczego TikTok wymaga zweryfikowanych adresów URL multimediów?

TikTok twierdzi, że weryfikacja własności adresów URL wideo pomaga mu zachować zgodność z zasadami dotyczącymi treści chronionych prawem autorskim i bezpieczeństwa użytkowników.

Czy zweryfikowana domena TikToka obejmuje jej subdomeny?

Tak. Subdomeny zweryfikowanej domeny liczą się jako zweryfikowane, choć /business/property/list/ pokazuje je tylko wtedy, gdy zostały dodane.

Czy API for Business TikToka może publikować z linku S3 lub CDN?

Tak, jeśli link znajduje się pod domeną lub prefiksem URL, które aplikacja zweryfikowała, na przykład pod prefiksem na zasobniku lub ścieżce CDN, którą kontrolujesz.

Czy posty ze zdjęciami też potrzebują zweryfikowanych adresów URL?

Tak. Endpoint dla zdjęć TikToka stwierdza, że posty ze zdjęciami nie mogą być publikowane z niezweryfikowanych adresów URL zdjęć.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w