Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Mga TikTok publish failure: spam_risk_too_many_posts, picture_size_check_failed, at iba pang fail reason

Pinangalanan ng TikTok ang dahilan ng pagkabigo ng post sa reason, sa status endpoint ng API for Business, o sa fail_reason ng Content Posting API. Ang mga check failure gaya ng picture_size_check_failed ay nangangahulugang lumalabag ang file sa isang format rule at kailangang palitan; ang video_pull_failed ay nangangahulugang hindi na-download ng TikTok ang video sa loob ng isang oras; ang spam_risk_too_many_posts ay nangangahulugang sobrang dami ng API post sa loob ng 24 oras. Ang failure na may markang internal ay maaaring i-retry lang.

Sinusubaybayan ng easyCoexistence ang bawat TikTok post na ini-publish nito hanggang makumpleto o mabigo ito ng TikTok, para sa Claude, ChatGPT o sa sarili ninyong platform: dumarating ang failure kasama ang reason ng TikTok sa email, sa Posts screen at bilang post.failed event, handa nang i-retry.

reason

Ang field na /business/publish/status/ ay lumalabas lamang kapag FAILED ang status, na may mga value gaya ng frame_rate_check_failed.

fail_reason

Ang pangalan ng Content Posting API para sa parehong field, sa mga response ng /v2/post/publish/status/fetch/.

1 hour

Timeout ng pag-download, pagkatapos nito ay ina-FAIL ng TikTok ang post na may video_pull_failed o photo_pull_failed.

24 hours

Panahong nagdudulot ng spam_risk_too_many_posts; iminumungkahi ng TikTok na i-publish ang post na iyon mula sa mobile app nito.

3 hours

Kadalasan, nagpapadala ang easyCoexistence ng email sa owner tungkol sa mga nabigong post sa isang channel; naghihintay ang post sa ilalim ng Needs attention.

Saan ipinapakita ng TikTok kung bakit nabigo ang post?

Pagkatapos ng publish call, na nagsisimula lamang ng gawain: ang code 0 nito ay nangangahulugang tinanggap ng TikTok ang request, hindi na tiyak na lalabas ang post. Binabasa ng GET /business/publish/status/ ang FAILED na may reason, at ang app na naka-subscribe sa publishing webhooks ay tumatanggap ng post.publish.failed na may parehong reason at publish_id. Ibinabalik ng /v2/post/publish/status/fetch/ ng Content Posting API ang field bilang 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"
  }
}

Ano ang ibig sabihin ng bawat fail reason, at ano ang nag-aayos nito?

Ang mga reason ng TikTok, ayon sa events reference nito para sa post publishing, kasama ang ayos na itinuturo ng bawat isa. Ang unang apat ay mga check na ginagawa ng TikTok sa file pagkatapos nitong i-download, at lahat ay minarkahang hindi maaaring i-retry. Sa failure table ng TikTok, 60 segundo pa rin ang pinakamahabang video para sa duration_check_failed, samantalang nakadokumento sa video endpoint ang 600, o ang sariling max_video_post_duration_sec ng account:

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

Aling mga failure ang maaaring i-retry?

Ang mga sanhi ng pag-download o ng TikTok mismo. Ang iba ay nangangailangan ng ibang file o caption, pahinga, o walang gagawin:

  • I-retry nang ganoon: internal, at ang video_pull_failed o photo_pull_failed kapag public at sapat ang bilis ng URL.
  • I-retry gamit ang bagong file: file_format_check_failed, duration_check_failed, frame_rate_check_failed at picture_size_check_failed.
  • I-retry gamit ang bagong caption: spam_risk_text.
  • Maghintay, o mag-post mula sa TikTok app: spam_risk_too_many_posts.
  • Huwag i-retry: auth_removed at spam_risk, ayon sa payo ng TikTok, o spam_risk_user_banned_from_posting.

Paano nagkakaiba ang mga failure ng Content Posting API?

Parehong reason, iba't ibang field at endpoint, at mga pagtanggi na nangyayari bago pa magsimula ang processing. Ibinabalik ng /v2/post/publish/status/fetch/ ang fail_reason, pinapayagan ang 30 request kada minuto bawat user token, at nagdadagdag ng payong huwag i-retry para sa spam_risk_user_banned_from_posting at spam_risk_text. May ilang pagtanggi na dumarating sa init call, na may HTTP 403:

  • spam_risk_too_many_posts: naabot ng creator ang araw-araw na post cap ng API.
  • unaudited_client_can_only_post_to_private_accounts: sinubukan ng unaudited na app na mag-post para sa public na account.
  • url_ownership_unverified: PULL_FROM_URL mula sa domain o prefix na hindi pa na-verify ng app.
  • privacy_level_option_mismatch: nawawala ang privacy_level o wala sa mga option ng creator.
  • reached_active_user_cap: naabot ng app ang araw-araw nitong quota ng active publishing users.

Ano ang nabibigo bago pa makita ng TikTok ang post?

Ang mga bagay na maaaring mahuli muna ng easyCoexistence, na may sariling mensahe sa halip na reason ng TikTok. Kinokopya ang media ng naka-iskedyul na post sa oras ng pag-iskedyul, at tinatanggihan ang link na nagbabalik ng web page, 404, maling uri, o file na lampas sa 30 MB para sa larawan o 1 GB para sa video. Tinatanggihan agad ang photo link na nagtatapos sa .png, .gif, .bmp, .heic, .avif o .svg bago pa may maipadala, ang channel na kailangang i-reconnect sa oras ng pag-post ay mabibigo bilang reconnect, at kapag tinanggal ang channel, kinakansela ang mga naka-iskedyul nitong post.

Paano iniuulat ng easyCoexistence ang nabigong TikTok post?

Sa pamamagitan ng posting queue nito, na sumusubaybay sa bawat TikTok post pagkatapos ng publish call, tinitingnan ang /business/publish/status/ halos bawat 20 segundo hanggang PUBLISH_COMPLETE. Ang FAILED na status ay nagpapabigo sa post, at ang error nito ay nagpapangalan sa reason ng TikTok sa loob ng panaklong, gaya ng frame_rate_check_failed, at bawat failure ay may dalang failure_kind:

  • refused: sinabi ng TikTok na hindi, gaya ng FAILED na status at reason nito.
  • uncertain: walang malinaw na sagot ang publish call, o walang kumpirmasyon ang TikTok sa loob ng 2 oras, kaya maaaring live na ang post (may_be_published).
  • reconnect: tinanggihan ng TikTok ang token ng account, at kailangan ng bagong sign-in.
  • internal: nabigo ang easyCoexistence bago ibigay ang post, kaya walang nalabas.

Paano ninyo mahahanap at mai-retry ang nabigong post?

Tumatanggap ng email ang owner para sa failure na nakita sa background, hanggang isa kada channel kada 3 oras, at tumatanggap ng post.failed ang events URL ng platform. Lumalabas ang post sa ilalim ng Needs attention sa Posts screen, may Retry, Reconnect at Dismiss, at ibinabalik ito ng list_scheduled_posts sa Claude o ChatGPT. Ini-publish muli ng retry_scheduled_post ang post, ngayon na, mula sa mga file na itinatago nang 7 araw pagkatapos ng failure; kapag true ang may_be_published, tingnan muna ang list_social_posts at ipasa ang confirm lamang kung wala ang post. Ang post na nangangailangan ng bagong file o caption ay muling iniskedyul sa halip.

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 }

Mga karaniwang pagkakamali

  • Pag-retry ng check failure gamit ang parehong file. Minarkahan ng TikTok ang mga failure sa format, duration, frame rate at picture size bilang hindi maaaring i-retry.
  • Pag-retry agad ng spam_risk_too_many_posts. Binibilang ng TikTok ang API post sa loob ng 24 oras at iminumungkahing mag-post mula sa mobile app.
  • Pag-retry ng post na may markang may_be_published nang hindi tinitingnan. Maaaring na-publish na ito ng TikTok; tingnan ang pinakabagong post ng account, o maipapadala ito nang dalawang beses.
  • Paghahanap ng fail_reason sa API for Business. Ang status endpoint nito ay nagpapangalan sa field na reason; ang fail_reason ay nasa Content Posting API.
Ginagawa ito gamit ang EasyCoexistence

US$ 9 hanggang US$ 0.75 kada connection kada buwan, bumababa habang dumarami ang connection, na may unang 3 araw na libre.

Mga madalas itanong

Ano ang ibig sabihin ng picture_size_check_failed sa TikTok?

Dinownload ng TikTok ang post at nakitang mas maliit sa minimum na 360 pixel ang taas at lapad ng larawan nito; kailangan ng mas malaking file, dahil minarkahan ng TikTok ang failure bilang hindi maaaring i-retry.

Ano ang video_pull_failed?

Hindi na-download ng TikTok ang video mula sa URL nito, o hindi ito natapos sa loob ng isang oras na timeout. Tiyakin na public ang URL at hindi limitado ang bandwidth, saka i-retry.

Gaano katagal ang spam_risk_too_many_posts?

Binibilang ng TikTok ang mga post na ginawa sa pamamagitan ng API sa nakaraang 24 oras, mga 15 kada araw bawat account, at iminumungkahing mag-publish mula sa TikTok mobile app habang naghihintay.

Awtomatikong nire-retry ba ng easyCoexistence ang nabigong TikTok post?

Hindi, pagkatapos mag-report ng TikTok ng FAILED: naghihintay ang post sa ilalim ng Needs attention at nakakatanggap ng email ang owner, at ipinapadala ulit ito ng Retry o ng retry_scheduled_post.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong