TikTok yayın hataları: spam_risk_too_many_posts, picture_size_check_failed ve diğer hata nedenleri
TikTok, başarısız bir gönderinin nedenini API for Business durum uç noktasındaki reason alanında, Content Posting API'sindeki fail_reason alanında ise bildirir. picture_size_check_failed gibi kontrol hataları dosyanın bir biçim kuralını ihlal ettiği ve değiştirilmesi gerektiği anlamına gelir. video_pull_failed, TikTok'un dosyayı bir saat içinde indiremediği anlamına gelir. spam_risk_too_many_posts ise 24 saat içinde çok fazla API gönderisi yapıldığı anlamına gelir. internal olarak işaretlenmiş bir hata yalnızca yeniden denenebilir.
easyCoexistence, yayımladığı her TikTok gönderisini TikTok onu tamamlayana ya da başarısız sayana kadar izler; Claude, ChatGPT veya kendi platformunuz için.
Alan /business/publish/status/ yalnızca durum FAILED olduğunda döner; frame_rate_check_failed gibi değerler içerir.
Aynı alanın Content Posting API'nin adı, /v2/post/publish/status/fetch/ yanıtlarında geçer.
TikTok'un gönderiyi video_pull_failed veya photo_pull_failed ile başarısız saydığı indirme zaman aşımı.
spam_risk_too_many_posts penceresi; TikTok bu durumda gönderiyi mobil uygulamasından yayımlamayı önerir.
Çoğunlukla easyCoexistence, bir kanaldaki başarısız gönderiler hakkında hesap sahibine e-posta gönderir; gönderi Dikkat gerektirenler altında bekler.
TikTok, bir gönderinin neden başarısız olduğunu nerede bildirir?
Yayın çağrısı yalnızca görevi başlatır; kodu 0, TikTok'un çağrıyı kabul ettiği anlamına gelir, gönderinin yayına gireceği anlamına gelmez. GET /business/publish/status/ o zaman FAILED durumunu ve reason nedenini döndürür. Yayın webhook'larına abone olan bir uygulama ise aynı nedenle ve publish_id ile post.publish.failed olayını alır. Content Posting API'nin /v2/post/publish/status/fetch/ uç noktası alanı fail_reason olarak döndürür:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Her hata nedeni ne anlama gelir ve neyi düzeltir?
TikTok'un gönderi yayın olayları referansında tanımladığı nedenler ve her birinin işaret ettiği çözüm. İlk dördü, dosyayı indirdikten sonra TikTok'un dosya üzerinde yaptığı kontroller olup hepsi yeniden denenemez olarak işaretlidir. TikTok'un hata tablosu hâlâ duration_check_failed için en uzun video süresini 60 saniye olarak veriyor; video uç noktası ise bunu 600, ya da hesabın kendi max_video_post_duration_sec değeri olarak belgeliyor:
| 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 |
Hangi hatalar yeniden denenebilir?
İndirmeden veya TikTok'un kendisinden kaynaklananlar. Gerisi farklı bir dosya veya başlık, bir bekleme ya da hiçbir şey gerektirmez:
- Olduğu gibi yeniden deneyin: internal ve URL herkese açık ve yeterince hızlı olduğunda
video_pull_failedveyaphoto_pull_failed. - Yeni bir dosyayla yeniden deneyin:
file_format_check_failed,duration_check_failed,frame_rate_check_failedvepicture_size_check_failed. - Yeni bir başlıkla yeniden deneyin:
spam_risk_text. - Bekleyin veya TikTok uygulamasından yayımlayın:
spam_risk_too_many_posts. - Yeniden denemeyin: TikTok'un önerdiği gibi
auth_removedvespam_riskilespam_risk_user_banned_from_posting.
Content Posting API'nin hataları nasıl farklı?
Aynı nedenler, farklı bir alan ve uç nokta ve işlem başlamadan önce gelen reddetmeler. /v2/post/publish/status/fetch/ alanı fail_reason olarak döndürür, kullanıcı token'ı başına dakikada 30 istek izin verir ve spam_risk_user_banned_from_posting ile spam_risk_text için yeniden denememe önerisi ekler. Bazı reddetmeler bunun yerine init çağrısında, HTTP 403 ile gelir:
spam_risk_too_many_posts: içerik üreticisi API'nin günlük gönderi sınırına ulaştı.unaudited_client_can_only_post_to_private_accounts: denetlenmemiş bir uygulama herkese açık bir hesap için göndermeye çalıştı.url_ownership_unverified: uygulamanın doğrulamadığı bir alan adı veya önektenPULL_FROM_URLile gönderim.privacy_level_option_mismatch:privacy_leveleksik veya içerik üreticisinin seçenekleri dışında.reached_active_user_cap: uygulama aktif yayın kullanıcılarının günlük kotasına ulaştı.
Gönderi TikTok'a ulaşmadan önce ne başarısız olur?
easyCoexistence'ın, TikTok nedeni yerine kendi mesajıyla önce yakalayabildikleri. Zamanlanmış bir gönderinin medyası zamanlandığı anda kopyalanır; web sayfası döndüren, 404 veren, yanlış türde olan bağlantılar veya görsel için 30 MB'ı, video için 1 GB'ı aşan dosyalar o anda reddedilir. .png, .gif, .bmp, .heic, .avif veya .svg ile biten fotoğraf bağlantıları hiçbir şey gönderilmeden reddedilir. Gönderi sırasında yeniden bağlanması gereken bir kanal reconnect olarak başarısız olur. Bir kanalı kaldırmak ise o kanalın zamanlanmış gönderilerini iptal eder.
easyCoexistence başarısız bir TikTok gönderisini nasıl bildirir?
Yayın çağrısından sonra her TikTok gönderisini izleyen yayın kuyruğu üzerinden; PUBLISH_COMPLETE olana kadar yaklaşık her 20 saniyede bir /business/publish/status/ kontrol edilir. FAILED durumu gönderiyi başarısız sayar. Hata, TikTok'un nedenini parantez içinde adlandırır, örneğin (frame_rate_check_failed), ve her hata bir failure_kind taşır:
- refused: TikTok hayır yanıtı verdi; FAILED durumu ve nedeniyle birlikte.
- uncertain: yayın çağrısı net bir yanıt alamadı veya TikTok 2 saat içinde onay vermedi, bu yüzden gönderi yayında olabilir (
may_be_published). - reconnect: TikTok hesabın token'ını reddetti ve hesabın yeniden oturum açması gerekiyor.
- internal: easyCoexistence gönderiyi devretmeden önce başarısız oldu, bu nedenle hiçbir şey gönderilmedi.
Başarısız bir gönderiyi nasıl bulup yeniden denersiniz?
Arka planda bulunan bir hata için hesap sahibi e-posta alır; kanal başına en fazla 3 saatte bir. Bir platformun olay URL'si ise post.failed alır. Gönderi, Gönderiler ekranında Dikkat gerektirenler altında Yeniden dene, Yeniden bağlan ve Yoksay seçenekleriyle görünür; list_scheduled_posts ise onu Claude veya ChatGPT'ye döndürür. retry_scheduled_post, gönderiyi şimdi, hatadan sonra 7 gün saklanan dosyalardan yeniden yayımlar. may_be_published true olduğunda önce list_social_posts'a bakın ve gönderi yoksa yalnızca confirm parametresini geçirin. Yeni bir dosya veya başlık gerektiren bir gönderi ise bunun yerine yeniden zamanlanır.
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 }Yaygın hatalar
- Aynı dosyayla bir kontrol hatasını yeniden denemek. TikTok biçim, süre, kare hızı ve görsel boyutu hatalarını yeniden denenemez olarak işaretler.
- spam_risk_too_many_posts hatasını hemen yeniden denemek. TikTok API gönderilerini son 24 saatte sayar ve mobil uygulamadan yayımlamayı önerir.
- may_be_published işaretli bir gönderiyi kontrol etmeden yeniden denemek. TikTok onu yayımlamış olabilir; hesabın son gönderilerine bakılmazsa iki kez yayımlanır.
- API for Business'ta fail_reason alanını aramak. Bu durum uç noktası alanı reason olarak adlandırır; fail_reason ise Content Posting API'nin alanıdır.
Bir hata, TikTok'un nedeniyle birlikte e-postayla, Gönderiler ekranında ve post.failed olayı olarak gelir; yeniden denemeye hazırdır. Bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar, bağlantı sayısı arttıkça düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
picture_size_check_failed TikTok'ta ne anlama gelir?
TikTok gönderiyi indirdi ve görselinin yükseklik ve genişlikte 360 piksel alt sınırının altında olduğunu gördü. Daha büyük bir dosya gerekir, çünkü TikTok bu hatayı yeniden denenemez olarak işaretler.
video_pull_failed nedir?
TikTok videoyu URL'sinden indiremedi ya da bir saatlik zaman aşımı içinde indiremedi. URL'nin herkese açık ve bant genişliği sınırlı olmadığını kontrol edin, ardından yeniden deneyin.
spam_risk_too_many_posts ne kadar sürer?
TikTok, son 24 saatte API üzerinden yapılan gönderileri sayar; bu, hesap başına günde yaklaşık 15 gönderi. Bu arada TikTok mobil uygulamasından yayımlamayı önerir.
easyCoexistence başarısız bir TikTok gönderisini kendiliğinden yeniden dener mi?
TikTok FAILED bildirdikten sonra hayır. Gönderi Dikkat gerektirenler altında bekler ve hesap sahibine e-posta gönderilir. Yeniden dene düğmesi veya retry_scheduled_post gönderiyi yeniden yollar.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi