Jak sprawdzić status publikacji posta TikTok przez API
TikTok publikuje posty przez API asynchronicznie: wywołanie publikacji zwraca share_id, a GET /business/publish/status/ z tym identyfikatorem jako publish_id pokazuje, na jakim etapie jest post. Status ma wartość PROCESSING_DOWNLOAD, gdy TikTok pobiera plik, PUBLISH_COMPLETE, gdy post przeszedł moderację i został opublikowany, albo FAILED z przyczyną, na przykład frame_rate_check_failed.
easyCoexistence publikuje na TikTok przez publish_tiktok_post i śledzi każdy post przez get_tiktok_publish_status, z poziomu Claude, ChatGPT lub własnego kodu, dzięki czemu Twój asystent AI widzi status TikTok i przyczynę błędu w chwili obecnej.
Jak długo identyfikatory postów mogą się pojawić po PUBLISH_COMPLETE; TikTok zaleca ponowić sprawdzenie po trzech minutach, jeśli ich brakuje.
Szacunek TikTok dotyczący pobierania pliku posta o rozmiarze 1 GB; rzeczywisty czas zależy od rozmiaru pliku i sieci.
Zwykle najdłuższy czas oczekiwania, po zakończeniu przesyłania, na udostępnienie posta publicznie; ręczna moderacja może trwać dłużej.
Limit czasu pobierania, po którym TikTok kończy post błędem video_pull_failed lub photo_pull_failed.
Po co śledzić post TikTok?
Ponieważ TikTok publikuje go w tle. Wywołanie publikacji uruchamia zadanie i natychmiast zwraca share_id; następnie TikTok pobiera plik spod wskazanego adresu, sprawdza format, przeprowadza moderację i udostępnia post publicznie. Post może jeszcze się nie powieść, mimo że samo wywołanie zakończyło się sukcesem.
Jakie są statusy?
GET /business/publish/status/ przyjmuje business_id konta oraz share_id jako publish_id i zwraca jeden z czterech statusów:
PROCESSING_DOWNLOAD: TikTok pobiera treść spod wskazanego adresu.PUBLISH_COMPLETE: post przeszedł moderację i został opublikowany;post_idszawiera jego identyfikatory, gdy jest widoczny publicznie.- FAILED: publikacja została zatrzymana, a reason podaje przyczynę.
SEND_TO_USER_INBOX: wersja robocza została przesłana, a TikTok powiadomił skrzynkę odbiorczą twórcy; dotyczy wyłącznie wersji roboczych.
Jak długo trwa publikacja?
TikTok nie podaje stałego czasu. Pobieranie zależy od rozmiaru pliku i sieci; według ogólnego szacunku TikTok 30 minut wystarcza dla pliku 1 GB, a godzina to limit. Potem post zwykle staje się publiczny w ciągu 2 minut, a później, gdy wymaga ręcznej moderacji. Jego post ID może pojawić się w statusie z opóźnieniem do trzech minut.
Co oznaczają przyczyny błędów?
reason podaje, co zatrzymało post. Niektóre oznaczają, że plik trzeba zmienić, inne, że ponowna próba może się udać:
file_format_check_failed,duration_check_failed,frame_rate_check_failed,picture_size_check_failed: plik narusza zasadę formatu, a TikTok oznacza je jako niemożliwe do ponowienia.video_pull_failed,photo_pull_failed: TikTok nie mógł pobrać pliku lub nie zrobił tego w ciągu godziny; ponów próbę, gdy adres będzie publicznie dostępny.- internal: część usługi TikTok była niedostępna i ponowna próba jest w porządku.
spam_risk_too_many_posts,spam_risk,spam_risk_text: TikTok zatrzymał post ze względu na liczbę postów, zachowanie lub treść podpisu.auth_removed: konto cofnęło dostęp aplikacji podczas przetwarzania, a TikTok zaleca nie ponawiać próby.spam_risk_user_banned_from_posting: konto ma zakaz publikowania nowych postów.
Do czego służy identyfikator posta?
Do późniejszego odnalezienia posta. Dokumentacja TikTok przekazuje identyfikatory postów do /business/video/list/ w polu filters.video_ids, aby odczytać metryki postów. Wywołania komentarzy natomiast przyjmują item_id posta z listy wideo konta jako video_id, co jest także parametrem post_id w narzędziach komentarzy easyCoexistence.
Jak easyCoexistence śledzi post?
publish_tiktok_post zwraca share_id TikTok z informacją, że TikTok przetwarza post, a get_tiktok_publish_status przyjmuje ten share_id i zwraca aktualny status TikTok, wraz z przyczyną, jeśli istnieje. Poproś swojego asystenta AI, by sprawdził ponownie po kilku minutach, a nie od razu.
Typowe błędy
- Publikowanie ponownie, bo nic jeszcze nie widać. Pierwsze wywołanie tylko uruchomiło zadanie, więc sprawdź jego status, zanim wyślesz post po raz drugi.
- Traktowanie PUBLISH_COMPLETE bez post_ids jako błędu. Identyfikatory mogą pojawić się nawet po trzech minutach, więc sprawdź wtedy ponownie.
- Ponawianie próby po błędzie formatu tym samym plikiem. file_format_check_failed i pozostałe błędy kontroli wymagają poprawionego pliku.
- Wyłączenie dostępu pod wskazanym adresem w trakcie pobierania. TikTok kończy post błędem video_pull_failed lub photo_pull_failed, gdy nie może pobrać pliku.
US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, pierwsze 3 dni bezpłatnie.
Najczęściej zadawane pytania
Czym jest share_id w TikTok?
Identyfikatorem zadania publikacji, zwracanym przez endpointy publikacji wideo i zdjęć. Trafia do wywołania statusu jako publish_id.
Czy istnieje webhook dla statusu publikacji TikTok?
Tak. Aplikacja zasubskrybowana z event_type VIDEO przez /business/webhook/update/ otrzymuje zdarzenia publikacji postów TikTok, na przykład post.publish.failed z polem reason i publish_id, zamiast powtarzać sprawdzanie statusu.
Dlaczego opublikowany post nie ma jeszcze identyfikatora?
TikTok może potrzebować do trzech minut po PUBLISH_COMPLETE, by zwrócić post_ids, i zwraca je tylko dla postów widocznych publicznie.
Czy nieudany post TikTok można ponowić?
Zależy od przyczyny. Błędy pobierania i wewnętrzne można ponowić; błędy formatu, czasu trwania, liczby klatek na sekundę i rozmiaru obrazu wymagają poprawionego pliku.
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