Cara memeriksa status publikasi postingan TikTok lewat API
TikTok mempublikasikan postingan API secara asinkron: panggilan publish mengembalikan share_id, dan GET /business/publish/status/ dengan ID itu sebagai publish_id menunjukkan posisi postingan. Statusnya PROCESSING_DOWNLOAD selama TikTok mengambil file, PUBLISH_COMPLETE setelah postingan lolos moderasi dan terbit, atau FAILED dengan alasan seperti frame_rate_check_failed.
easyCoexistence mempublikasikan ke TikTok dengan publish_tiktok_post dan memantau setiap postingan dengan get_tiktok_publish_status, dari Claude, ChatGPT, atau kode Anda sendiri, sehingga AI Anda melihat status TikTok dan alasan kegagalan apa pun sebagaimana adanya.
Berapa lama post ID bisa muncul setelah PUBLISH_COMPLETE; TikTok menyarankan mencoba lagi setelah tiga menit jika ID belum ada.
Perkiraan umum TikTok untuk mengunduh file postingan 1 GB; waktu sebenarnya bergantung pada ukuran dan jaringan.
Waktu tunggu terlama yang biasa, setelah unggahan selesai, hingga postingan menjadi publik; moderasi manual bisa lebih lama.
Batas waktu unduhan, setelah itu TikTok menggagalkan postingan dengan video_pull_failed atau photo_pull_failed.
Mengapa postingan TikTok perlu dipantau?
Karena TikTok memprosesnya di latar belakang. Panggilan publish memulai sebuah tugas dan langsung mengembalikan share_id; lalu TikTok mengunduh file dari URL-nya, memeriksa format, menjalankan moderasi, dan membuat postingan menjadi publik. Postingan masih bisa gagal meskipun panggilan itu sendiri berhasil.
Apa saja statusnya?
GET /business/publish/status/ menerima business_id akun dan share_id sebagai publish_id, lalu mengembalikan salah satu dari empat status:
PROCESSING_DOWNLOAD: TikTok sedang mengunduh konten dari URL-nya.PUBLISH_COMPLETE: postingan telah lolos moderasi dan diterbitkan;post_idsberisi daftarnya begitu bisa dilihat publik.- FAILED: publikasi berhenti, dan reason menjelaskan sebabnya.
SEND_TO_USER_INBOX: draf telah diunggah dan TikTok memberi tahu kotak masuk kreator; ini hanya berlaku untuk draf.
Berapa lama proses publikasi?
TikTok tidak memberikan waktu tetap. Pengunduhan bergantung pada ukuran file dan jaringan; perkiraan umum TikTok adalah 30 menit cukup untuk file 1 GB, dengan satu jam sebagai batas. Setelah itu, postingan biasanya menjadi publik dalam 2 menit, atau lebih lama jika perlu moderasi manual, dan post ID-nya bisa membutuhkan hingga tiga menit tambahan untuk muncul di status.
Apa arti alasan kegagalan?
reason menyebutkan apa yang menghentikan postingan. Sebagian berarti file harus diubah, sebagian lain berarti mencoba kembali bisa berhasil:
file_format_check_failed,duration_check_failed,frame_rate_check_failed,picture_size_check_failed: file melanggar aturan format, dan TikTok menandainya sebagai tidak bisa dicoba kembali.video_pull_failed,photo_pull_failed: TikTok tidak dapat mengunduh file, atau tidak dalam satu jam; cobalah kembali setelah URL dapat diakses publik.- internal: sebagian layanan TikTok tidak tersedia, dan mencoba kembali tidak masalah.
spam_risk_too_many_posts,spam_risk,spam_risk_text: TikTok menghentikan postingan karena volume, perilaku, atau isi keterangannya.auth_removed: akun mencabut akses aplikasi selama pemrosesan, dan TikTok menyarankan untuk tidak mencoba kembali.spam_risk_user_banned_from_posting: akun diblokir dari membuat postingan baru.
Untuk apa post ID?
Untuk menemukan postingan setelahnya. Referensi TikTok meneruskan post ID ke /business/video/list/ dalam filters.video_ids untuk membaca metrik postingan. Panggilan komentar, di sisi lain, mengambil item_id postingan dari daftar video akun sebagai video_id, yang juga diambil oleh alat komentar easyCoexistence sebagai post_id.
Bagaimana easyCoexistence memantau postingan?
publish_tiktok_post mengembalikan share_id dari TikTok beserta catatan bahwa TikTok sedang memproses postingan, dan get_tiktok_publish_status menerima share_id itu lalu mengembalikan status TikTok sebagaimana adanya, beserta alasannya bila ada. Mintalah AI Anda memeriksa lagi setelah beberapa menit, bukan langsung.
Kesalahan umum
- Memublikasikan ulang karena belum ada yang muncul. Panggilan pertama hanya memulai tugas, jadi periksa statusnya sebelum mengirim postingan untuk kedua kalinya.
- Menganggap PUBLISH_COMPLETE tanpa post_ids sebagai kesalahan. ID bisa membutuhkan hingga tiga menit lebih lama, jadi periksa lagi nanti.
- Mencoba kembali kegagalan format dengan file yang sama. file_format_check_failed dan kegagalan pemeriksaan lainnya memerlukan file yang sudah diperbaiki.
- Mematikan URL selama pengunduhan. TikTok menggagalkan postingan dengan video_pull_failed atau photo_pull_failed bila tidak dapat mengambil file.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apa itu share_id di TikTok?
ID tugas publikasi, yang dikembalikan oleh endpoint publikasi video dan foto. ID ini dimasukkan ke panggilan status sebagai publish_id.
Apakah ada webhook untuk status publikasi TikTok?
Ada. Aplikasi yang berlangganan dengan event_type VIDEO melalui /business/webhook/update/ menerima event publikasi postingan TikTok, seperti post.publish.failed beserta reason dan publish_id-nya, sebagai pengganti pemeriksaan status yang berulang.
Mengapa postingan yang sudah terbit belum punya post ID?
TikTok bisa membutuhkan hingga tiga menit setelah PUBLISH_COMPLETE untuk mengembalikan post_ids, dan hanya mengembalikannya untuk postingan yang bisa dilihat publik.
Bisakah postingan TikTok yang gagal dicoba kembali?
Bergantung pada alasannya. Kegagalan unduhan dan internal bisa dicoba kembali; kegagalan format, durasi, frame rate, dan ukuran gambar memerlukan file yang sudah diperbaiki.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada