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

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.

3 min

Jak długo identyfikatory postów mogą się pojawić po PUBLISH_COMPLETE; TikTok zaleca ponowić sprawdzenie po trzech minutach, jeśli ich brakuje.

30 min

Szacunek TikTok dotyczący pobierania pliku posta o rozmiarze 1 GB; rzeczywisty czas zależy od rozmiaru pliku i sieci.

2 min

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.

1 hour

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_ids zawiera 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.
Z EasyCoexistence zrobisz to

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