Błędy publikacji na TikToku: spam_risk_too_many_posts, picture_size_check_failed i inne przyczyny niepowodzeń
TikTok podaje przyczynę nieudanego posta w polu reason, zwracanym przez endpoint statusu API for Business, albo w polu fail_reason w Content Posting API. Błędy kontroli, takie jak picture_size_check_failed, oznaczają, że plik łamie zasadę formatu i trzeba go zmienić. video_pull_failed oznacza, że TikTok nie zdołał pobrać pliku w ciągu godziny. spam_risk_too_many_posts oznacza zbyt wiele postów przez API w ciągu 24 godzin. Błąd oznaczony jako internal można po prostu ponowić.
easyCoexistence śledzi każdy post na TikToku, który publikuje, aż TikTok go ukończy albo odrzuci, dla Claude, ChatGPT lub Twojej własnej platformy: błąd trafia e-mailem, na ekran Posts i jako zdarzenie post.failed, gotowy do ponowienia.
Pole /business/publish/status/ zwracane jest tylko przy statusie FAILED, z wartościami takimi jak frame_rate_check_failed.
Nazwa tego samego pola w Content Posting API, w odpowiedziach /v2/post/publish/status/fetch/.
Czas pobierania, po którym TikTok kończy post błędem video_pull_failed lub photo_pull_failed.
Okno liczenia dla spam_risk_too_many_posts; TikTok sugeruje wtedy publikację tego posta z aplikacji mobilnej.
Najczęściej easyCoexistence wysyła właścicielowi e-mail o nieudanych postach na jednym kanale; post czeka w sekcji „Needs attention”.
Skąd TikTok podaje, dlaczego post się nie udał?
Po wywołaniu publikacji, które jedynie uruchamia zadanie, kod 0 oznacza, że TikTok przyjął zgłoszenie, a nie że post na pewno się ukaże. GET /business/publish/status/ zwraca wtedy FAILED z polem reason, a aplikacja zapisana na webhooki publikacji otrzymuje post.publish.failed z tym samym powodem i publish_id. Endpoint /v2/post/publish/status/fetch/ w Content Posting API zwraca to pole jako fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Co oznacza każdy powód niepowodzenia i jak go naprawić?
Powody TikToka, zgodnie z opisem w dokumentacji zdarzeń publikacji posta, obok poprawki, na którą wskazuje każdy z nich. Pierwsze cztery to kontrole pliku, które TikTok wykonuje po jego pobraniu; wszystkie są oznaczone jako niepodlegające ponowieniu. Tabela błędów TikToka wciąż podaje 60 sekund jako najdłuższy film dla duration_check_failed, a endpoint dla wideo dokumentuje 600 sekund albo wartość max_video_post_duration_sec danego konta:
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
Które błędy można ponowić?
Te spowodowane pobieraniem albo samym TikTokiem. Pozostałe wymagają innego pliku lub opisu, przerwy albo niczego:
- Ponów bez zmian: internal oraz
video_pull_failedlubphoto_pull_failed, gdy URL jest publiczny i wystarczająco szybki. - Ponów z nowym plikiem:
file_format_check_failed,duration_check_failed,frame_rate_check_failedipicture_size_check_failed. - Ponów z nowym opisem:
spam_risk_text. - Poczekaj albo opublikuj z aplikacji TikTok:
spam_risk_too_many_posts. - Nie ponawiaj:
auth_removedispam_risk, zgodnie z zaleceniem TikToka, albospam_risk_user_banned_from_posting.
Czym różnią się błędy Content Posting API?
Te same powody, inne pole i endpoint oraz odmowy, które pojawiają się przed rozpoczęciem przetwarzania. /v2/post/publish/status/fetch/ zwraca fail_reason, dopuszcza 30 żądań na minutę na token użytkownika i zaznacza, że nie warto ponawiać spam_risk_user_banned_from_posting oraz spam_risk_text. Kilka odmów przychodzi zamiast tego już przy wywołaniu init, z HTTP 403:
spam_risk_too_many_posts: twórca osiągnął dzienny limit postów w API.unaudited_client_can_only_post_to_private_accounts: niezaudytowana aplikacja próbowała opublikować na koncie publicznym.url_ownership_unverified:PULL_FROM_URLz domeny lub prefiksu, których aplikacja nie zweryfikowała.privacy_level_option_mismatch:privacy_levelbrakuje albo jest spoza opcji dostępnych dla twórcy.reached_active_user_cap: aplikacja osiągnęła dzienny limit aktywnych użytkowników publikujących.
Co się psuje, zanim TikTok zobaczy post?
Błędy, które easyCoexistence wychwytuje wcześniej, mają własny komunikat zamiast powodu TikToka. Media zaplanowanego posta są kopiowane w momencie planowania; link zwracający stronę WWW, 404, zły typ albo plik większy niż 30 MB dla obrazu lub 1 GB dla wideo jest wtedy odrzucany. Linki do zdjęć kończące się na .png, .gif, .bmp, .heic, .avif lub .svg są odrzucane, zanim cokolwiek zostanie wysłane. Kanał wymagający ponownego połączenia w chwili publikacji kończy się błędem reconnect, a usunięcie kanału anuluje jego zaplanowane posty.
Jak easyCoexistence raportuje nieudany post na TikToku?
Przez kolejkę publikacji, która po wywołaniu publikacji śledzi każdy post TikToka, sprawdzając /business/publish/status/ około co 20 sekund, aż do PUBLISH_COMPLETE. Status FAILED kończy post błędem, którego komunikat podaje w nawiasie powód TikToka, na przykład frame_rate_check_failed, a każdy błąd ma failure_kind:
- refused: TikTok odpowiedział odmownie, jak przy statusie FAILED i jego powodzie.
- uncertain: wywołanie publikacji nie dało jasnej odpowiedzi albo TikTok nie potwierdził w ciągu 2 godzin, więc post może być już opublikowany (
may_be_published). - reconnect: TikTok odrzucił token konta i konto wymaga nowego logowania.
- internal: easyCoexistence zawiódł przed przekazaniem posta, więc nic nie zostało wysłane.
Jak znaleźć i ponowić nieudany post?
Właściciel dostaje e-mail o błędzie wykrytym w tle, najwyżej jeden na kanał co 3 godziny, a adres URL zdarzeń platformy otrzymuje post.failed. Post pojawia się w sekcji „Needs attention” na ekranie Posts, z przyciskami Retry, Reconnect i Dismiss, a list_scheduled_posts zwraca go do Claude lub ChatGPT. retry_scheduled_post publikuje go ponownie od razu, z plików przechowywanych 7 dni po błędzie; gdy may_be_published ma wartość true, najpierw sprawdź list_social_posts i podaj confirm tylko wtedy, gdy posta brakuje. Post wymagający nowego pliku lub opisu jest zamiast tego zaplanowany ponownie.
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }
retry_scheduled_post { "post_id": "<POST_ID>" }
// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }Typowe błędy
- Ponawianie błędu kontroli tym samym plikiem. TikTok oznacza błędy formatu, czasu trwania, liczby klatek i rozmiaru obrazu jako niepodlegające ponowieniu.
- Ponawianie spam_risk_too_many_posts od razu. TikTok liczy posty z API z ostatnich 24 godzin i sugeruje publikację z aplikacji mobilnej.
- Ponawianie posta oznaczonego may_be_published bez sprawdzenia. TikTok mógł go już opublikować; sprawdź najnowsze posty konta, w przeciwnym razie zostanie opublikowany dwukrotnie.
- Szukanie fail_reason w API for Business. Jego endpoint statusu nazywa pole reason; fail_reason należy do Content Posting API.
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, mniej w miarę dodawania połączeń, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Co oznacza picture_size_check_failed na TikToku?
TikTok pobrał post i stwierdził, że obraz jest mniejszy niż minimum 360 pikseli w wysokości i szerokości. Potrzebujesz większego pliku, bo TikTok oznacza ten błąd jako niepodlegający ponowieniu.
Czym jest video_pull_failed?
TikTok nie zdołał pobrać wideo z jego adresu URL albo nie zrobił tego w ciągu jednogodzinnego limitu czasu. Sprawdź, czy URL jest publiczny i nie ogranicza przepustowości, a potem ponów próbę.
Jak długo trwa spam_risk_too_many_posts?
TikTok liczy posty wykonane przez API w ciągu ostatnich 24 godzin, około 15 dziennie na konto. Do tego czasu sugeruje publikację z aplikacji mobilnej TikToka.
Czy easyCoexistence sam ponawia nieudany post na TikToku?
Nie po zgłoszeniu FAILED przez TikTok: post czeka w sekcji „Needs attention”, właściciel dostaje e-mail, a Retry albo retry_scheduled_post wysyła go ponownie.
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