Kegagalan siaran TikTok: spam_risk_too_many_posts, picture_size_check_failed dan sebab kegagalan lain
TikTok menamakan punca siaran yang gagal dalam medan reason, pada endpoint status API perniagaan TikTok, atau sebagai fail_reason dalam Content Posting API. Kegagalan semakan seperti picture_size_check_failed bermakna fail melanggar peraturan format dan perlu diubah; video_pull_failed bermakna TikTok tidak dapat memuat turunnya dalam masa sejam; spam_risk_too_many_posts bermakna terlalu banyak siaran API dalam tempoh 24 jam. Kegagalan yang ditandakan sebagai internal boleh dicuba semula begitu sahaja.
easyCoexistence menjejaki setiap siaran TikTok yang diterbitkannya sehingga TikTok melengkapkan atau menggagalkannya, untuk Claude, ChatGPT atau platform anda sendiri: kegagalan tiba dengan sebab TikTok melalui e-mel, pada skrin Siaran dan sebagai peristiwa post.failed, sedia untuk dicuba semula.
Medan /business/publish/status/ hanya dikembalikan apabila status ialah FAILED, dengan nilai seperti frame_rate_check_failed.
Nama medan yang sama dalam Content Posting API, dalam respons /v2/post/publish/status/fetch/.
Tempoh tamat muat turun, selepas itu TikTok menggagalkan siaran dengan video_pull_failed atau photo_pull_failed.
Tempoh di sebalik spam_risk_too_many_posts; TikTok mencadangkan siaran itu diterbitkan dari aplikasi mudah alihnya sebaliknya.
Selalunya easyCoexistence menghantar e-mel kepada pemilik mengenai siaran yang gagal pada satu saluran; siaran itu menunggu di bawah Perlu perhatian.
Di mana TikTok melaporkan sebab siaran gagal?
Selepas panggilan terbitan, yang hanya memulakan tugas: kod 0 bermaksud TikTok menerimanya, bukan bahawa siaran itu akan tersiar. GET /business/publish/status/ kemudian membaca FAILED dengan reason, dan aplikasi yang melanggan webhook penerbitan menerima post.publish.failed dengan sebab yang sama serta publish_id. /v2/post/publish/status/fetch/ bagi Content Posting API memulangkan medan itu sebagai fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Apakah maksud setiap sebab kegagalan, dan apakah pembetulannya?
Sebab-sebab TikTok, seperti yang diterangkan dalam rujukan peristiwa siaran terbitannya, bersama pembetulan yang ditunjuk oleh setiap satu. Empat yang pertama ialah semakan yang TikTok jalankan ke atas fail selepas memuat turunnya, semuanya ditandakan tidak boleh dicuba semula. Jadual kegagalan TikTok masih memberikan 60 saat sebagai video terpanjang bagi duration_check_failed, manakala endpoint video mendokumentasikan 600, atau max_video_post_duration_sec akaun itu sendiri:
| 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 |
Kegagalan mana yang boleh dicuba semula?
Yang disebabkan oleh muat turun atau oleh TikTok sendiri. Yang lain memerlukan fail atau kapsyen yang berbeza, jeda, atau tiada tindakan langsung:
- Cuba semula seperti sedia ada: internal, dan
video_pull_failedatauphoto_pull_failedapabila URL sudah awam dan cukup pantas. - Cuba semula dengan fail baharu:
file_format_check_failed,duration_check_failed,frame_rate_check_faileddanpicture_size_check_failed. - Cuba semula dengan kapsyen baharu:
spam_risk_text. - Tunggu, atau siarkan dari aplikasi TikTok:
spam_risk_too_many_posts. - Jangan cuba semula:
auth_removeddanspam_risk, seperti yang dinasihatkan TikTok, atauspam_risk_user_banned_from_posting.
Bagaimana kegagalan Content Posting API berbeza?
Sebab yang sama, medan dan endpoint yang berbeza, serta penolakan yang berlaku sebelum pemprosesan bermula. /v2/post/publish/status/fetch/ memulangkan fail_reason, membenarkan 30 permintaan seminit bagi setiap token pengguna, dan menambah nasihat jangan cuba semula untuk spam_risk_user_banned_from_posting dan spam_risk_text. Beberapa penolakan tiba pada panggilan init, dengan HTTP 403:
spam_risk_too_many_posts: pencipta mencapai had siaran harian API.unaudited_client_can_only_post_to_private_accounts: aplikasi yang tidak diaudit cuba menyiarkan untuk akaun awam.url_ownership_unverified:PULL_FROM_URLdaripada domain atau awalan yang belum disahkan oleh aplikasi.privacy_level_option_mismatch:privacy_leveltiada atau berada di luar pilihan pencipta.reached_active_user_cap: aplikasi mencapai kuota harian pengguna penerbitan aktif.
Apakah yang gagal sebelum TikTok melihat siaran?
Apa yang easyCoexistence boleh tangkap dahulu, dengan mesej tersendiri dan bukan sebab TikTok. Media siaran berjadual disalin pada masa dijadualkan, dan pautan yang memulangkan halaman web, 404, jenis yang salah, atau fail melebihi 30 MB untuk imej atau 1 GB untuk video ditolak pada ketika itu. Pautan foto yang berakhir dengan .png, .gif, .bmp, .heic, .avif atau .svg ditolak sebelum apa-apa dihantar, saluran yang perlu disambung semula pada masa siaran gagal dengan reconnect, dan membuang saluran membatalkan siaran berjadualnya.
Bagaimana easyCoexistence melaporkan siaran TikTok yang gagal?
Melalui barisan siaran, yang menjejaki setiap siaran TikTok selepas panggilan terbitan, dengan menyemak /business/publish/status/ kira-kira setiap 20 saat sehingga PUBLISH_COMPLETE. Status FAILED menggagalkan siaran itu, dengan ralat yang menamakan sebab TikTok dalam kurungan, seperti frame_rate_check_failed, dan setiap kegagalan membawa failure_kind:
- refused: TikTok menjawab tidak, seperti dengan status FAILED dan sebabnya.
- uncertain: panggilan terbitan tidak mendapat jawapan yang jelas, atau TikTok tidak memberikan pengesahan dalam tempoh 2 jam, maka siaran itu mungkin telah tersiar (
may_be_published). - reconnect: TikTok menolak token akaun, dan akaun itu perlu log masuk semula.
- internal: easyCoexistence gagal sebelum menyerahkan siaran, jadi tiada apa-apa yang dihantar.
Bagaimana anda mencari dan mencuba semula siaran yang gagal?
Pemilik menerima e-mel untuk kegagalan yang dikesan di latar belakang, paling banyak satu bagi setiap saluran setiap 3 jam, dan URL peristiwa bagi platform menerima post.failed. Siaran itu muncul di bawah Perlu perhatian pada skrin Siaran, dengan Cuba semula, Sambung semula dan Abaikan, dan list_scheduled_posts memulangkannya kepada Claude atau ChatGPT. retry_scheduled_post menerbitkannya semula, sekarang, daripada fail yang disimpan selama 7 hari selepas kegagalan; apabila may_be_published bernilai true, semak list_social_posts dahulu dan hantar confirm hanya jika siaran itu tiada. Siaran yang memerlukan fail atau kapsyen baharu dijadualkan semula sebaliknya.
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 }Kesilapan biasa
- Mencuba semula kegagalan semakan dengan fail yang sama. TikTok menandakan kegagalan format, tempoh, kadar bingkai dan saiz gambar sebagai tidak boleh dicuba semula.
- Mencuba semula spam_risk_too_many_posts serta-merta. TikTok mengira siaran API dalam tempoh 24 jam dan mencadangkan siaran dari aplikasi mudah alih.
- Mencuba semula siaran yang ditandakan may_be_published tanpa menyemak. TikTok mungkin telah menyiarkannya; semak siaran terkini akaun, atau ia akan tersiar dua kali.
- Mencari fail_reason pada API perniagaan TikTok. Endpoint statusnya menamakan medan itu reason; fail_reason tergolong dalam Content Posting API.
Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma.
Soalan lazim
Apakah maksud picture_size_check_failed pada TikTok?
TikTok memuat turun siaran dan mendapati imejnya kurang daripada minimum 360 piksel tinggi dan lebar; ia memerlukan fail yang lebih besar, kerana TikTok menandakan kegagalan itu sebagai tidak boleh dicuba semula.
Apakah video_pull_failed?
TikTok tidak dapat memuat turun video daripada URL-nya, atau tidak dalam tempoh tamat masa satu jam. Semak sama ada URL itu awam dan tidak dihadkan lebar jalur, kemudian cuba semula.
Berapa lama spam_risk_too_many_posts berlangsung?
TikTok mengira siaran yang dibuat melalui API dalam tempoh 24 jam yang lalu, kira-kira 15 sehari bagi setiap akaun, dan mencadangkan siaran dari aplikasi mudah alih TikTok sementara itu.
Adakah easyCoexistence mencuba semula siaran TikTok yang gagal dengan sendirinya?
Tidak selepas TikTok melaporkan FAILED: siaran itu menunggu di bawah Perlu perhatian dan pemilik menerima e-mel, dan Cuba semula atau retry_scheduled_post menghantarnya semula.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada