TikTok API gönderisinin yayımlanma durumu nasıl kontrol edilir
TikTok, API üzerinden gelen gönderileri eşzamansız yayımlar: yayımlama çağrısı bir share_id döndürür ve bu ID'yi publish_id olarak içeren GET /business/publish/status/ çağrısı gönderinin nerede olduğunu bildirir. Durum, TikTok dosyayı çekerken PROCESSING_DOWNLOAD, gönderi denetimden geçip yayımlandığında PUBLISH_COMPLETE, başarısız olduğunda ise frame_rate_check_failed gibi bir nedenle birlikte FAILED olarak görünür.
easyCoexistence, TikTok'a publish_tiktok_post ile yayımlar ve her gönderiyi get_tiktok_publish_status ile takip eder; bunu Claude, ChatGPT veya kendi kodunuzdan yapabilirsiniz.
PUBLISH_COMPLETE durumundan sonra gönderi ID'lerinin ne kadar sürede gelebileceği; eksikse TikTok üç dakika sonra yeniden denemeyi öneriyor.
1 GB'lık bir gönderi dosyasının indirilmesi için TikTok'un genel tahmini; gerçek süre dosya boyutuna ve ağa bağlıdır.
Yükleme tamamlandıktan sonra gönderinin herkese açık olması için genellikle en uzun bekleme süresi; manuel denetim daha uzun sürebilir.
TikTok'un video_pull_failed veya photo_pull_failed ile gönderiyi başarısız saydığı indirme zaman aşımı.
Neden bir TikTok gönderisini takip etmek gerekir?
Çünkü TikTok gönderiyi arka planda yayımlar. Yayımlama çağrısı bir görev başlatır ve hemen bir share_id döndürür; ardından TikTok dosyayı URL'sinden indirir, formatını denetler, moderasyondan geçirir ve gönderiyi herkese açar. Çağrının kendisi başarılı olsa bile gönderi daha sonra başarısız olabilir.
Hangi durumlar var?
GET /business/publish/status/ isteği, hesabın business_id değerini ve share_id değerini publish_id olarak alır ve dört durumdan birini döndürür:
PROCESSING_DOWNLOAD: TikTok içeriği URL'sinden indiriyor.PUBLISH_COMPLETE: gönderi denetimden geçti ve yayımlandı; herkese açık görüntülenebildiğindepost_idsonu listeler.- FAILED: yayımlama durdu ve reason nedenini belirtir.
SEND_TO_USER_INBOX: bir taslak yüklendi ve TikTok içerik üreticisinin gelen kutusuna bildirim gönderdi; yalnızca taslaklar için geçerlidir.
Yayımlama ne kadar sürer?
TikTok sabit bir süre vermez. İndirme süresi dosya boyutuna ve ağa bağlıdır; TikTok'un genel tahmini, 1 GB'lık bir dosya için 30 dakikanın yeterli olduğu, bir saatin ise sınır olduğu yönündedir. Bundan sonra gönderi genellikle 2 dakika içinde herkese açık olur; manuel denetim gerektiriyorsa daha geç olabilir ve gönderi ID'sinin durumda görünmesi üç dakikaya kadar daha sürebilir.
Hata nedenleri ne anlama gelir?
reason, gönderiyi durduran nedeni belirtir. Bazıları dosyanın değişmesi gerektiğini, bazıları ise yeniden denemenin işe yarayabileceğini gösterir:
file_format_check_failed,duration_check_failed,frame_rate_check_failed,picture_size_check_failed: dosya bir format kuralını ihlal ediyor; TikTok bunları yeniden denenemez olarak işaretler.video_pull_failed,photo_pull_failed: TikTok dosyayı indiremedi ya da bir saat içinde indiremedi; URL herkese açık olarak erişilebilir hale gelince yeniden deneyin.- internal: TikTok hizmetinin bir kısmı kullanılamadı; yeniden denemek uygundur.
spam_risk_too_many_posts,spam_risk,spam_risk_text: TikTok gönderiyi hacim, davranış ya da açıklama metninin içeriği nedeniyle durdurdu.auth_removed: hesap, işlem sırasında uygulamanın erişimini geri çekti; TikTok yeniden denemeyin diyor.spam_risk_user_banned_from_posting: hesap yeni gönderi paylaşmaktan yasaklanmış.
Gönderi ID'si ne işe yarar?
Gönderiyi sonradan bulmaya yarar. TikTok'un referansı, gönderilerin metriklerini okumak için gönderi ID'lerini filters.video_ids içinde /business/video/list/ uç noktasına iletir. Yorum çağrıları ise hesabın video listesinden bir gönderinin item_id değerini video_id olarak alır; easyCoexistence'ın yorum araçları da bunu post_id olarak alır.
easyCoexistence bir gönderiyi nasıl takip eder?
publish_tiktok_post, TikTok'un share_id değerini ve TikTok'un gönderiyi işlediğine dair bir notu döndürür. get_tiktok_publish_status bu share_id değerini alır ve varsa nedeniyle birlikte TikTok'un mevcut durumunu döndürür. Hemen değil, birkaç dakika sonra yapay zekanızdan yeniden kontrol etmesini isteyin.
Yaygın hatalar
- Henüz bir şey görünmediği için yeniden yayımlamak. İlk çağrı yalnızca görevi başlattı; gönderiyi ikinci kez göndermeden önce durumunu kontrol edin.
- PUBLISH_COMPLETE durumunu post_ids olmadan hata saymak. ID'ler üç dakika kadar daha geç gelebilir; o zaman yeniden kontrol edin.
- Bir format hatasını aynı dosyayla yeniden denemek. file_format_check_failed ve diğer denetim hataları düzeltilmiş bir dosya gerektirir.
- İndirme sırasında URL'yi kapatmak. TikTok dosyayı çekemediğinde gönderiyi video_pull_failed ya da photo_pull_failed ile başarısız sayar.
Böylece yapay zekanız TikTok'un durumunu ve varsa hata nedenini olduğu gibi görür. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
TikTok'ta share_id nedir?
Yayımlama görevinin kimliğidir; video ve fotoğraf yayımlama uç noktaları tarafından döndürülür. Durum çağrısına publish_id olarak girer.
TikTok yayımlama durumu için bir webhook var mı?
Evet. event_type VIDEO ile /business/webhook/update/ üzerinden abone olan bir uygulama, tekrar eden durum sorguları yerine post.publish.failed gibi TikTok gönderi yayımlama olaylarını nedeni ve publish_id ile alır.
Yayımlanmış bir TikTok gönderisinin neden henüz gönderi ID'si yok?
TikTok, PUBLISH_COMPLETE durumundan sonra post_ids döndürmesi için üç dakikaya kadar bekleyebilir ve bunu yalnızca herkese açık görüntülenebilen gönderiler için döndürür.
Başarısız bir TikTok gönderisi yeniden denenebilir mi?
Nedene bağlı olarak. İndirme ve internal hataları yeniden denenebilir; format, süre, kare hızı ve resim boyutu hataları ise düzeltilmiş bir dosya gerektirir.
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