TL;DR, szybka odpowiedź
8 min czytaniaZanim TikTok pobierze plik spod podanego adresu URL, musisz dodać tę domenę lub prefiks URL jako właściwość aplikacji w TikTok for Developers i udowodnić własność, co według TikToka polega na dodaniu "a signature string to the domain's DNS records." Weryfikacja działa tylko w dół: zweryfikowanie static.example.com obejmuje video.static.example.com, ale nie example.com. Prefiks URL jest dopasowywany dosłownie, więc segment ścieżki wstawiony w środku go psuje. Niezweryfikowany host zwraca HTTP 403 z kodem błędu url_ownership_unverified, a TikTok opisuje ten sam błąd na trzy sposoby na trzech stronach dokumentacji. Adres URL multimediów musi używać https, nie może przekierowywać i musi być dostępny przez całe godzinne okno pobierania.
Czym jest weryfikacja domeny pull_from_url w TikTok API?
Przejście weryfikacji domeny pull_from_url w TikTok API oznacza, że TikTok potwierdził twoją kontrolę nad hostem udostępniającym plik multimedialny, a bez tego potwierdzenia żaden plik nie zostanie pobrany. To kontrola własności adresu URL, a nie filmu, i odbywa się, zanim mechanizm pobierania TikToka nawiąże choćby jedno połączenie.
Kontrola dotyczy każdego wywołania init z source: "PULL_FROM_URL":
| Endpoint | Co robi | Pole z adresem URL |
|---|---|---|
/v2/post/publish/video/init/ | Bezpośrednia publikacja filmu (Direct Post) | source_info.video_url |
/v2/post/publish/inbox/video/init/ | Wysłanie filmu do skrzynki twórcy | source_info.video_url |
/v2/post/publish/content/init/ | Publikacja lub przesłanie zdjęć | source_info.photo_images |
Zdjęcia nie mają alternatywy. Endpoint zdjęć podaje, że "Only PULL_FROM_URL is allowed" w source_info.source, więc przy publikacji zdjęć weryfikacja nie jest optymalizacją, tylko warunkiem koniecznym. Filmy mogą ją ominąć przez przejście na FILE_UPLOAD, choć Content Sharing Guidelines TikToka zalecają coś przeciwnego: "If video resources are already on API Clients' servers, do not use FILE_UPLOAD; use PULL_FROM_URL instead."

Jak zweryfikować domenę w TikToku?
Dodajesz host jako właściwość aplikacji, a potem potwierdzasz kontrolę nad nim przez DNS. Media Transfer Guide TikToka opisuje ten proces jednym zdaniem:
"To confirm ownership, log into the TikTok for Developers website and add your Domain or URL Prefix property to your application in the URL properties widget as shown below. You must have manage or write access to the property."
O samej metodzie TikTok pisze: "To verify domain ownership, it is recommended that you add a signature string to the domain's DNS records." Słowo „recommended" sugeruje istnienie drugiej drogi, ale TikTok żadnej nie opisuje. Nie ma opublikowanej metody z metatagiem HTML ani z przesłaniem pliku, nie podano typu rekordu ani wskazówek co do TTL, nie wiadomo też, ile może trwać propagacja i czy TikTok sprawdza rekord ponownie. Jeśli DNS jest oddelegowany do dostawcy, którego nie kontrolujesz, to właśnie ta nieopisana luka cię zablokuje, a dokumentacja nie oferuje rozwiązania awaryjnego.
Sam mechanizm jest taki sam jak w przypadku własnej domeny jako nazwy użytkownika na Bluesky: ciąg znaków w rekordzie DNS dowodzi, że osoba prosząca o weryfikację zarządza też strefą.
Jak daleko sięga zweryfikowana domena?
W dół, nigdy w górę. TikTok podaje zasadę, a potem przykład, który ją konkretyzuje:
"Once the ownership of a domain is verified, all paths under that domain or its subdomains are considered owned by the developer application."
"For example, if you have verified the domain
static.example.com, then URLs likehttps://video.static.example.com/tiktok/example.mp4are considered verified, while URLs likehttps://example.com/videos/example.mp4are still considered unverified."
Przeczytaj drugą część jeszcze raz, bo to właśnie pułapka. Zweryfikowanie subdomeny nie weryfikuje domeny nadrzędnej. Zespół, który zweryfikuje cdn.example.com, a potem przeniesie zasoby do example.com/cdn/, całkowicie traci weryfikację, choć organizacja nadal jest właścicielem obu. Domena główna to osobna właściwość i wymaga własnego rekordu.
Właściwości typu URL Prefix są jeszcze węższe, a TikTok dokładnie określa ich postać: "A URL prefix consists of: https:// + host + path + /." Host "must be a domain and should not be an IP address", a dopasowanie jest dosłowne:
"For example, if you have already verified the domain
https://example.com/videos/user/, then URLs likehttps://example.com/videos/user/123/example.mp4are considered verified, while URLs likehttps://example.com/videos/2023/user/123/example.mp4are still considered unverified."
Zwróć uwagę, że w tym przykładzie TikTok nazywa prefiks URL "the domain". Sformułowanie jest luźne, ale działanie już nie: wstawienie 2023/ między videos/ a user/ tworzy ciąg, który nie zaczyna się od zweryfikowanego prefiksu, i żądanie kończy się błędem. Tak samo zawiedzie każdy układ magazynu, który umieszcza datę, identyfikator klienta lub numer sharda przed zweryfikowanym segmentem. To dobry argument za weryfikacją domeny zamiast głębokiej ścieżki.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
| Typ właściwości | Co obejmuje | Czego nie obejmuje |
|---|---|---|
| Domena | Każdą ścieżkę na tym hoście i w jego subdomenach | Domeny nadrzędnej |
| Prefiks URL | Każdy adres URL zaczynający się dosłownie od prefiksu | Adresu z segmentem ścieżki wstawionym przed końcem prefiksu |

Jakie są pozostałe zasady pull_from_url?
Obok własności obowiązują trzy warunki, a TikTok podaje każdy z nich bez ogródek.
Schemat jest ustalony: "The media URL must use "https" and should not redirect to another URL." Zasady dotyczące prefiksów mówią jeszcze dosadniej, co się stanie w przeciwnym razie: "Redirections are not followed. URLs that return HTTP 3xx are considered invalid." Usługa podpisanych adresów odpowiadająca kodem 302 do magazynu albo CDN przekierowujący żądanie o jeden skok są niewidoczne w teście w przeglądarce, a tutaj okazują się krytyczne. To jedno z niewielu miejsc, w których łańcuch przekierowań nie jest przypisem o wydajności, tylko zwyczajną awarią.
Adres musi działać przez cały czas zadania: "The URL must remain accessible for the entire duration of the download process, which times out one hour after the download task is initiated." Krótkotrwałe podpisane adresy muszą więc żyć dłużej niż godzinę, a nie tylko kilka minut.
Przepustowość ma podany pułap: "TikTok server's ingress bandwidth for file downloads can reach 100 Mbps." TikTok nie podaje minimum, więc serwer źródłowy z ograniczeniem przepustowości po prostu wyczerpuje czas, aż godzinny limit zakończy zadanie.
TikTok udostępnia też jedną furtkę do testów. Media Transfer Guide zawiera link do przykładowego pliku MP4 w jego własnym CDN i zaznacza, że można go wypróbować "without any verification", co pozwala przetestować pełny proces init i sprawdzania statusu, zanim powstanie rekord DNS.
Jak wygląda błąd url_ownership_unverified?
Niezweryfikowany host zwraca HTTP 403 z error.code ustawionym na url_ownership_unverified. Ciekawe jest to, że TikTok opisuje ten sam kod na trzy sposoby na trzech aktualnych stronach:
| Strona dokumentacji | Opis TikToka |
|---|---|
| Upload video | "To use PULL_FROM_URL as the video transfer method, the developer must verify the ownership of the URL prefix or domain." |
| Photo | "To use PULL_FROM_URL as the content transfer method, developer must verify the ownership of the URL prefix or domain." |
| Cancel a pull task | "To use PULL_FROM_URL as the media transfer method, developer must verify the ownership of the URL prefix or domain" |
"Video transfer method", "content transfer method" i "media transfer method" to ten sam mechanizm pod trzema nazwami. Dopasowuj ciąg kodu, nigdy treść komunikatu. Trzeci wiersz jest dziwniejszy niż samo sformułowanie: url_ownership_unverified pojawia się w opisie odpowiedzi /v2/post/publish/cancel/, endpointu przyjmującego tylko publish_id, bez żadnego adresu URL. TikTok nie wyjaśnia, jak żądanie anulowania może nie przejść kontroli własności, a lista pól nie daje ku temu żadnej możliwości.
Przejście weryfikacji nie oznacza udanego pobrania. Po potwierdzeniu własności błędy przenoszą się dalej, do fail_reason zwracanego przez /v2/post/publish/status/fetch/, gdzie video_pull_failed i photo_pull_failed mają wspólny opis: "The TikTok server encountered a connection error while downloading the specified video resource, or the download is terminated since it can not be completed within the one-hour timeout." Problemy z formatem i rozmiarem pojawiają się osobno jako file_format_check_failed lub picture_size_check_failed, podobnie jak wymagania Instagrama dotyczące zdjęć odrzucają plik, który został przesłany bez problemu.
Jedno pole warto ustawić w tym samym żądaniu. is_aigc oznacza treści syntetyczne już przy publikacji, a dwa rodzaje oznaczenia treści AI na TikToku działają zupełnie inaczej w zależności od tego, czy ustawisz je sam, czy wywnioskuje je TikTok.
Najczęściej zadawane pytania
Czy zweryfikowanie example.com weryfikuje też cdn.example.com?
Tak. TikTok podaje, że "all paths under that domain or its subdomains are considered owned by the developer application", więc zweryfikowana domena główna obejmuje swoje subdomeny. W drugą stronę to nie działa: zweryfikowanie cdn.example.com pozostawia example.com niezweryfikowane.
Czy mogę użyć adresu IP lub zwykłego adresu http?
Nie w obu przypadkach. TikTok wymaga, by "The media URL must use "https"", a definicja prefiksu URL podaje, że host "must be a domain and should not be an IP address."
Dlaczego mój podpisany adres S3 lub Cloud Storage nie przechodzi weryfikacji?
Zwykle dlatego, że host zasobnika nie jest właściwością twojej aplikacji albo podpisany adres odpowiada przekierowaniem. TikTok nie podąża za przekierowaniami i traktuje każdą odpowiedź HTTP 3xx jako nieprawidłową, więc skok do magazynu kończy próbę.
Ile adresów zdjęć może zawierać jedno żądanie?
Do 35. Endpoint zdjęć opisuje photo_images jako "An array containing up to 35 photo content URLs. The URLs must be publicly accessible and verified by your app", a każdy z tych adresów podlega tej samej kontroli własności.
Czy godzinne okno zaczyna się przy init, czy przy pierwszym bajcie?
W chwili rozpoczęcia zadania. TikTok podaje, że pobieranie "times out one hour after the download task is initiated", więc wolny serwer źródłowy zużywa ten sam czas co duży plik, a zadanie kończy się statusem video_pull_failed, zamiast czekać.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Czy mogę anulować trwające pobieranie?
Tylko w miarę możliwości. /v2/post/publish/cancel/ przyjmuje publish_id, a TikTok ostrzega, że "it is not feasible to cancel downloads that are nearing completion or already in the file processing state." Udane anulowanie pojawia się później jako przyczyna błędu publish_cancelled.
Czy mogę całkowicie pominąć weryfikację domeny w TikToku?
Tylko przy publikacji filmów. Przejście na metodę FILE_UPLOAD usuwa kontrolę własności, choć Content Sharing Guidelines TikToka odradzają to w przypadku filmów znajdujących się już na twoich serwerach. Zdjęcia nie mają takiej opcji: endpoint zdjęć dopuszcza tylko PULL_FROM_URL, więc weryfikacja jest tam obowiązkowa.
Czy TikTok pozwala przetestować PULL_FROM_URL przed dodaniem rekordu DNS?
TikTok udostępnia do tego dokładnie jedną furtkę. Media Transfer Guide zawiera link do przykładowego pliku MP4 w jego własnym CDN i podaje, że działa on "without any verification", więc pełny proces init i sprawdzania statusu uruchomisz przed dodaniem rekordu DNS. Dotyczy to tylko tego jednego pliku, a nie twoich multimediów.
Jak szybko TikTok pobiera plik spod mojego adresu?
Do pułapu podanego przez TikToka: 100 Mb/s przepustowości przychodzącej dla pobieranych plików. TikTok nie publikuje minimalnej prędkości dla serwera źródłowego, więc serwer z ograniczeniem przepustowości po prostu wyczerpuje godzinny limit, aż zadanie zakończy się statusem video_pull_failed lub photo_pull_failed.
Czym różni się url_ownership_unverified od video_pull_failed?
url_ownership_unverified to kontrola na wejściu: TikTok odrzuca wywołanie init kodem HTTP 403, zanim w ogóle połączy się z twoim adresem. video_pull_failed oraz jego odpowiednik dla zdjęć photo_pull_failed pojawiają się później, już po potwierdzeniu własności, gdy samo pobieranie napotka błąd połączenia lub przekroczy godzinny limit.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Oznaczenie treści AI na TikToku to w rzeczywistości dwa różne oznaczenia
Oznaczenie AI na TikToku pojawia się na dwa sposoby: jako etykieta twórcy ustawiana przez is_aigc i jako etykieta automatyczna z efektów AI lub C2PA, której nie usuniesz.


Jak działa tryb zdjęć na TikToku: 35 zdjęć i dwa pola tekstowe
Tryb zdjęć na TikToku pozwala dodać do 35 zdjęć w poście. Przez API każdy obraz to JPEG lub WebP do 20 MB, z tytułem do 90 runów i opisem do 4 000 runów.


Jak działa dzienny limit postów na TikToku dla aplikacji i narzędzi do planowania
Dzienny limit postów na TikToku: dokumentacja API podaje 15 postów Direct Post na twórcę, 5 oczekujących szkiców i limit wspólny dla wszystkich aplikacji.
Powiązane artykuły


Dlaczego deweloperzy potrzebują zatwierdzenia aplikacji, by publikować na TikToku publicznie
Bez zatwierdzenia aplikacji posty z API zostają SELF_ONLY, a publikować może dziennie tylko 5 prywatnych kont. Co sprawdza audyt i jakie błędy zobaczysz.


Jak w TikTok API muszą się zgadzać chunk_size i total_chunk_count
chunk_size w TikTok API ma dolną granicę 5 MB, górną 64 MB, końcowy fragment do 128 MB oraz total_chunk_count, który trzeba zaokrąglać w dół, a nie w górę.


Co pole creator_info max_video_post_duration_sec na TikToku mówi przed publikacją
Pole creator_info max_video_post_duration_sec na TikToku to najdłuższy film, jaki może opublikować dany twórca. Wartość zależy od konta, więc sprawdzaj ją przed każdym postem.

