Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Cara menyemak status penerbitan siaran TikTok melalui API

TikTok menerbitkan siaran API secara tak segerak: panggilan penerbitan mengembalikan share_id, dan GET /business/publish/status/ dengan ID itu sebagai publish_id menunjukkan kedudukan siaran. Status dibaca PROCESSING_DOWNLOAD semasa TikTok memuat turun fail, PUBLISH_COMPLETE apabila siaran telah lulus penyederhanaan dan diterbitkan, atau FAILED dengan sebab seperti frame_rate_check_failed.

easyCoexistence menerbitkan ke TikTok dengan publish_tiktok_post dan menjejak setiap siaran dengan get_tiktok_publish_status, daripada Claude, ChatGPT atau kod anda sendiri, supaya AI anda melihat status TikTok dan sebab kegagalan seperti keadaannya sekarang.

3 min

Berapa lama ID siaran boleh mengambil masa selepas PUBLISH_COMPLETE; TikTok menyatakan cuba semula selepas tiga minit jika ia tiada.

30 min

Anggaran umum TikTok untuk memuat turun fail siaran 1 GB; masa sebenar bergantung pada saiz dan rangkaian.

2 min

Tempoh menunggu paling lama yang biasa, selepas muat naik selesai, untuk siaran menjadi awam; penyederhanaan manual boleh mengambil masa lebih lama.

1 hour

Tamat masa muat turun, selepas itu TikTok menggagalkan siaran dengan video_pull_failed atau photo_pull_failed.

Mengapa siaran TikTok perlu dijejak?

Kerana TikTok menerbitkannya di latar belakang. Panggilan penerbitan memulakan tugasan dan segera mengembalikan share_id; kemudian TikTok memuat turun fail dari URL-nya, menyemak format, menjalankan penyederhanaan dan menjadikan siaran awam. Siaran masih boleh gagal walaupun panggilan itu sendiri berjaya.

Apakah status yang ada?

GET /business/publish/status/ mengambil business_id akaun dan share_id sebagai publish_id, dan mengembalikan salah satu daripada empat status:

  • PROCESSING_DOWNLOAD: TikTok sedang memuat turun kandungan dari URL-nya.
  • PUBLISH_COMPLETE: siaran telah lulus penyederhanaan dan diterbitkan; post_ids menyenaraikannya apabila ia boleh dilihat secara umum.
  • FAILED: penerbitan terhenti, dan reason menerangkan sebabnya.
  • SEND_TO_USER_INBOX: draf telah dimuat naik dan TikTok memberitahu peti masuk pencipta; ia hanya terpakai untuk draf.

Berapa lama penerbitan mengambil masa?

TikTok tidak memberikan masa tetap. Muat turun bergantung pada saiz fail dan rangkaian, dan anggaran umum TikTok ialah 30 minit sudah memadai untuk fail 1 GB, dengan satu jam sebagai had. Selepas itu, siaran biasanya menjadi awam dalam masa 2 minit, atau lebih lama apabila ia memerlukan penyederhanaan manual, dan ID siarannya boleh mengambil masa sehingga tiga minit lagi untuk muncul dalam status.

Apakah maksud sebab kegagalan?

reason menamakan apa yang menghentikan siaran. Ada yang bermakna fail perlu diubah, ada yang bermakna cubaan semula boleh berjaya:

  • file_format_check_failed, duration_check_failed, frame_rate_check_failed, picture_size_check_failed: fail itu melanggar peraturan format, dan TikTok menandakannya sebagai tidak boleh dicuba semula.
  • video_pull_failed, photo_pull_failed: TikTok tidak dapat memuat turun fail, atau tidak dalam tempoh satu jam; cuba semula sebaik URL boleh dicapai secara umum.
  • internal: sebahagian perkhidmatan TikTok tidak tersedia, dan cubaan semula boleh dibuat.
  • spam_risk_too_many_posts, spam_risk, spam_risk_text: TikTok menghentikan siaran kerana jumlah, tingkah laku atau kandungan kapsyen.
  • auth_removed: akaun menarik balik akses aplikasi semasa pemprosesan, dan TikTok menyatakan jangan cuba semula.
  • spam_risk_user_banned_from_posting: akaun dilarang daripada membuat siaran baharu.

Untuk apa ID siaran?

Untuk mencari siaran itu kemudian. Rujukan TikTok menghantar ID siaran kepada /business/video/list/ dalam filters.video_ids untuk membaca metrik siaran. Panggilan ulasan pula mengambil item_id siaran daripada senarai video akaun sebagai video_id, yang juga diambil oleh alat ulasan easyCoexistence sebagai post_id.

Bagaimana easyCoexistence menjejak siaran?

publish_tiktok_post mengembalikan share_id TikTok dengan nota bahawa TikTok sedang memproses siaran, dan get_tiktok_publish_status mengambil share_id itu serta mengembalikan status TikTok seperti keadaannya sekarang, dengan sebab apabila ada. Minta AI anda menyemak semula selepas beberapa minit, bukan serta-merta.

Kesilapan biasa

  • Menerbitkan siaran itu sekali lagi kerana belum ada apa-apa yang muncul. Panggilan pertama hanya memulakan tugasan, jadi semak statusnya dahulu.
  • Menganggap PUBLISH_COMPLETE tanpa post_ids sebagai ralat. ID itu boleh mengambil masa sehingga tiga minit lagi, jadi semak semula ketika itu.
  • Mencuba semula kegagalan format dengan fail yang sama. file_format_check_failed dan semua kegagalan semakan lain memerlukan fail yang telah dibetulkan.
  • Menutup URL semasa muat turun. TikTok menggagalkan siaran dengan video_pull_failed atau photo_pull_failed apabila ia tidak dapat mengambil fail.
Menggunakan EasyCoexistence untuk ini

US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama adalah percuma.

Soalan lazim

Apakah itu share_id pada TikTok?

ID bagi satu tugasan penerbitan, dikembalikan oleh endpoint penerbitan video dan foto. Ia dimasukkan ke dalam panggilan status sebagai publish_id.

Adakah webhook untuk status penerbitan TikTok?

Ada. Aplikasi yang melanggan event_type VIDEO melalui /business/webhook/update/ menerima peristiwa penerbitan siaran TikTok, seperti post.publish.failed dengan reason dan publish_id, sebagai ganti semakan status berulang.

Mengapa siaran yang diterbitkan belum mempunyai ID siaran?

TikTok boleh mengambil masa sehingga tiga minit selepas PUBLISH_COMPLETE untuk mengembalikan post_ids, dan hanya mengembalikannya untuk siaran yang boleh dilihat secara umum.

Bolehkah siaran TikTok yang gagal dicuba semula?

Bergantung pada sebabnya. Kegagalan muat turun dan dalaman boleh dicuba semula; kegagalan format, tempoh, kadar bingkai dan saiz gambar memerlukan fail yang telah dibetulkan.

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