Słownik

Dlaczego weryfikacja domeny pull_from_url w TikTok API odrzuca twój host

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Zweryfikowana domena przekazująca adres URL multimediów do TikTok Content Posting APIZweryfikowana domena przekazująca adres URL multimediów do TikTok Content Posting API

TL;DR, szybka odpowiedź

8 min czytania

Zanim 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":

EndpointCo robiPole 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órcysource_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."

Osoba pracuje na laptopie, czyli przy stanowisku, z którego dodaje się rekord DNS podczas weryfikacji własności domeny.

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 naprawdę przebiega weryfikacja domeny
1
Dodaj właściwość. Dodaj domenę lub prefiks URL w widżecie URL properties swojej aplikacji w TikTok for Developers, mając uprawnienia do zarządzania lub zapisu.
2
Dodaj rekord DNS. Dodaj do rekordów DNS domeny ciąg podpisu otrzymany od TikToka.
3
Czekaj, bez udokumentowanej reguły. TikTok nie podaje typu rekordu, TTL ani czasu propagacji, więc nie wiesz, jak długo to potrwa.
4
Wywołania init działają. Gdy TikTok potwierdzi rekord, każda ścieżka na tym hoście i w jego subdomenach liczy się jako zweryfikowana.
Jedyna udokumentowana metoda weryfikacji to ciąg podpisu w DNS, a TikTok nie podaje, ile trwa jego potwierdzenie.

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 like https://video.static.example.com/tiktok/example.mp4 are considered verified, while URLs like https://example.com/videos/example.mp4 are 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 like https://example.com/videos/user/123/example.mp4 are considered verified, while URLs like https://example.com/videos/2023/user/123/example.mp4 are 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
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Typ właściwościCo obejmujeCzego nie obejmuje
DomenaKażdą ścieżkę na tym hoście i w jego subdomenachDomeny nadrzędnej
Prefiks URLKażdy adres URL zaczynający się dosłownie od prefiksuAdresu z segmentem ścieżki wstawionym przed końcem prefiksu

Kable sieciowe w serwerowni, symbolizujące serwer źródłowy, który musi pozostać dostępny podczas pobierania pliku.

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 dokumentacjiOpis 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
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.

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

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

Powiązane artykuły