Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

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.

reason

Alan /business/publish/status/ yalnızca durum FAILED olduğunda döner; frame_rate_check_failed gibi değerler içerir.

fail_reason

Aynı alanın Content Posting API'nin adı, /v2/post/publish/status/fetch/ yanıtlarında geçer.

1 hour

TikTok'un gönderiyi video_pull_failed veya photo_pull_failed ile başarısız saydığı indirme zaman aşımı.

24 hours

spam_risk_too_many_posts penceresi; TikTok bu durumda gönderiyi mobil uygulamasından yayımlamayı önerir.

3 hours

Ç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:

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"
  }
}

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 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

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_failed veya photo_pull_failed.
  • Yeni bir dosyayla yeniden deneyin: file_format_check_failed, duration_check_failed, frame_rate_check_failed ve picture_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_removed ve spam_risk ile spam_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 önekten PULL_FROM_URL ile gönderim.
  • privacy_level_option_mismatch: privacy_level eksik 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.

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 }

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.
Bunu EasyCoexistence'la yapmak

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