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

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.

reason

Pole /business/publish/status/ zwracane jest tylko przy statusie FAILED, z wartościami takimi jak frame_rate_check_failed.

fail_reason

Nazwa tego samego pola w Content Posting API, w odpowiedziach /v2/post/publish/status/fetch/.

1 hour

Czas pobierania, po którym TikTok kończy post błędem video_pull_failed lub photo_pull_failed.

24 hours

Okno liczenia dla spam_risk_too_many_posts; TikTok sugeruje wtedy publikację tego posta z aplikacji mobilnej.

3 hours

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:

A failed post in /business/publish/status/, from TikTok's example
{
  "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 foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing 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_failed lub photo_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_failed i picture_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_removed i spam_risk, zgodnie z zaleceniem TikToka, albo spam_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_URL z domeny lub prefiksu, których aplikacja nie zweryfikowała.
  • privacy_level_option_mismatch: privacy_level brakuje 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.

Failed posts through MCP
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.
Z EasyCoexistence zrobisz to

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