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.
Od tego momentu TikTok odrzuca adresy wideo, które nie znajdują się w zweryfikowanej domenie lub prefiksie URL.
Od tego momentu endpointy właściwości URL wymagają także sekretu aplikacji dewelopera.
Wartości property_type: 1 dla domeny, 2 dla prefiksu URL.
Wartości property_status: pending, verified oraz not verified, co oznacza, że próba się nie powiodła i trzeba ją powtórzyć.
Deweloperzy, którzy opublikowali wideo wcześniej, mieli domeny tych adresów wideo ustawione automatycznie na zweryfikowane.
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_failedlubphoto_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:
| 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 |
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ącymproperty_typei url; odpowiedź zwraca signature, a dla prefiksu takżefile_name, zproperty_status0. - 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_status1 oznacza zweryfikowaną, a 2 oznacza, że próba się nie powiodła.
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_nameJak 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:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Jak 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.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Typowe 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ć.
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