Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Eșecuri la publicarea pe TikTok: spam_risk_too_many_posts, picture_size_check_failed și altele

TikTok indică cauza unei postări eșuate în câmpul reason, la endpoint-ul de stare din API for Business, sau în câmpul fail_reason din Content Posting API. Erorile de verificare, precum picture_size_check_failed, înseamnă că fișierul încalcă o regulă de format și trebuie modificat; video_pull_failed înseamnă că TikTok nu a putut descărca fișierul în decurs de o oră; spam_risk_too_many_posts înseamnă prea multe postări prin API în 24 de ore. Un eșec marcat internal poate fi pur și simplu reîncercat.

easyCoexistence urmărește fiecare postare TikTok pe care o publică până când TikTok o finalizează sau o respinge, pentru Claude, ChatGPT sau propria platformă: un eșec ajunge cu motivul TikTok pe e-mail, în ecranul Postări și ca eveniment post.failed, gata de reîncercare.

reason

Câmpul /business/publish/status/ este returnat doar când statusul este FAILED, cu valori precum frame_rate_check_failed.

fail_reason

Numele aceluiași câmp în Content Posting API, în răspunsurile /v2/post/publish/status/fetch/.

1 hour

Timpul de descărcare după care TikTok eșuează o postare cu video_pull_failed sau photo_pull_failed.

24 hours

Fereastra din spatele lui spam_risk_too_many_posts; TikTok sugerează publicarea acelei postări din aplicația sa mobilă.

3 hours

Cel mai des, easyCoexistence trimite un e-mail proprietarului despre postările eșuate pe un canal; postarea așteaptă la „Necesită atenție”.

Unde raportează TikTok motivul eșecului unei postări?

După apelul de publicare, care doar pornește sarcina de publicare: codul 0 înseamnă că TikTok a acceptat-o, nu că postarea va fi publicată. GET /business/publish/status/ returnează apoi FAILED cu reason, iar o aplicație abonată la webhook-urile de publicare primește post.publish.failed cu același reason și publish_id. Endpoint-ul /v2/post/publish/status/fetch/ din Content Posting API returnează câmpul ca 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"
  }
}

Ce înseamnă fiecare motiv de eșec și cum se remediază?

Motivele TikTok, așa cum sunt descrise în referința sa pentru evenimentele de publicare a postărilor, alături de remedierea la care trimite fiecare. Primele patru sunt verificări pe care TikTok le face asupra fișierului după descărcare, toate marcate ca neputând fi reîncercate. Tabelul de eșecuri al TikTok indică încă 60 de secunde drept cel mai lung videoclip pentru duration_check_failed, în timp ce endpoint-ul video documentează 600, sau valoarea proprie a contului, max_video_post_duration_sec:

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

Ce eșecuri pot fi reîncercate?

Cele cauzate de descărcare sau de TikTok însuși. Celelalte cer un alt fișier sau alt text, o pauză sau nicio acțiune:

  • Reîncercați ca atare: internal și video_pull_failed sau photo_pull_failed, odată ce URL-ul este public și suficient de rapid.
  • Reîncercați cu un fișier nou: file_format_check_failed, duration_check_failed, frame_rate_check_failed și picture_size_check_failed.
  • Reîncercați cu un text nou: spam_risk_text.
  • Așteptați sau publicați din aplicația TikTok: spam_risk_too_many_posts.
  • Nu reîncercați: auth_removed și spam_risk, cum recomandă TikTok, sau spam_risk_user_banned_from_posting.

Cum diferă eșecurile din Content Posting API?

Aceleași motive, alt câmp și alt endpoint, plus refuzuri care survin înainte ca procesarea să înceapă. /v2/post/publish/status/fetch/ returnează fail_reason, permite 30 de cereri pe minut pentru fiecare token de utilizator și adaugă recomandarea de a nu reîncerca pentru spam_risk_user_banned_from_posting și spam_risk_text. Mai multe refuzuri sosesc în schimb la apelul de inițiere, cu HTTP 403:

  • spam_risk_too_many_posts: creatorul a atins plafonul zilnic de postări al API-ului.
  • unaudited_client_can_only_post_to_private_accounts: o aplicație neauditată a încercat să publice pentru un cont public.
  • url_ownership_unverified: PULL_FROM_URL dintr-un domeniu sau un prefix pe care aplicația nu l-a verificat.
  • privacy_level_option_mismatch: un privacy_level lipsă sau în afara opțiunilor creatorului.
  • reached_active_user_cap: aplicația a atins cota zilnică de utilizatori activi pentru publicare.

Ce eșuează înainte ca TikTok să vadă postarea?

Ce poate detecta primul easyCoexistence, cu un mesaj propriu în loc de un motiv TikTok. Fișierul media al unei postări programate este copiat în momentul programării, iar un link care întoarce o pagină web, o eroare 404, un tip greșit sau un fișier mai mare de 30 MB pentru o imagine ori 1 GB pentru un videoclip este refuzat atunci. Linkurile către fotografii care se termină în .png, .gif, .bmp, .heic, .avif sau .svg sunt refuzate înainte de a fi trimis ceva, un canal care trebuie reconectat la momentul publicării eșuează cu motivul reconnect, iar eliminarea unui canal anulează postările sale programate.

Cum raportează easyCoexistence o postare TikTok eșuată?

Prin coada sa de publicare, care urmărește fiecare postare TikTok după apelul de publicare, verificând /business/publish/status/ la aproximativ 20 de secunde până la PUBLISH_COMPLETE. Un status FAILED marchează postarea ca eșuată, iar eroarea numește motivul TikTok între paranteze, de exemplu frame_rate_check_failed, iar fiecare eșec poartă un failure_kind:

  • refused: TikTok a răspuns negativ, ca în cazul unui status FAILED și al motivului său.
  • uncertain: apelul de publicare nu a primit un răspuns clar sau TikTok nu a confirmat în 2 ore, deci postarea poate fi live (may_be_published).
  • reconnect: TikTok a refuzat token-ul contului, iar acesta trebuie autentificat din nou.
  • internal: easyCoexistence a eșuat înainte de a trimite postarea, deci nimic nu a fost trimis.

Cum găsiți și reîncercați o postare eșuată?

Proprietarul primește un e-mail pentru un eșec găsit în fundal, cel mult unul pe canal la fiecare 3 ore, iar URL-ul de evenimente al unei platforme primește post.failed. Postarea apare la „Necesită atenție” din ecranul Postări, cu butoanele Reîncearcă, Reconectează și Ignoră, iar list_scheduled_posts o returnează către Claude sau ChatGPT. retry_scheduled_post o publică din nou, acum, din fișierele păstrate 7 zile după eșec; când may_be_published este true, verificați mai întâi list_social_posts și transmiteți parametrul confirm doar dacă postarea lipsește. O postare care are nevoie de un fișier sau un text nou este programată din nou în schimb.

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 }

Greșeli frecvente

  • Reîncercarea unui eșec de verificare cu același fișier. TikTok marchează eșecurile de format, durată, rată de cadre și dimensiune a imaginii drept neputând fi reîncercate.
  • Reîncercarea imediată a lui spam_risk_too_many_posts. TikTok numără postările API din 24 de ore și sugerează publicarea din aplicația mobilă.
  • Reîncercarea unei postări marcate may_be_published fără verificare. TikTok ar fi putut-o publica deja; verificați ultimele postări ale contului, altfel ajunge publicată de două ori.
  • Căutarea fail_reason în API for Business. Endpoint-ul său de stare numește câmpul reason; fail_reason aparține Content Posting API.
Faceți acest lucru cu EasyCoexistence

US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Ce înseamnă picture_size_check_failed pe TikTok?

TikTok a descărcat postarea și a constatat că imaginea are sub minimul de 360 de pixeli, atât pe înălțime, cât și pe lățime; e nevoie de un fișier mai mare, deoarece TikTok marchează eșecul ca neputând fi reîncercat.

Ce este video_pull_failed?

TikTok nu a putut descărca videoclipul de la URL-ul său sau nu a reușit în limita de o oră. Verificați că URL-ul este public și nelimitat ca lățime de bandă, apoi reîncercați.

Cât durează spam_risk_too_many_posts?

TikTok numără postările făcute prin API în ultimele 24 de ore, adică aproximativ 15 pe zi pe cont, și sugerează între timp publicarea din aplicația mobilă TikTok.

Reîncearcă easyCoexistence singur o postare TikTok eșuată?

Nu, după ce TikTok raportează FAILED: postarea așteaptă la „Necesită atenție”, proprietarul primește un e-mail, iar butonul Reîncearcă sau retry_scheduled_post o trimite din nou.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la