Mengirim video ke draf creator TikTok lewat API
API TikTok mengirim video ke draf creator lewat alur unggah: /v2/post/publish/inbox/video/init/ pada Content Posting API mengunggahnya di bawah scope video.upload, dan TikTok mengirim notifikasi kotak masuk agar creator mengedit dan memposting di aplikasi. API for Business melakukan hal yang sama dengan upload_to_draft pada /business/video/publish/, atau is_draft pada unggahan foto.
easyCoexistence mempublikasikan video TikTok dan postingan foto dengan publish_tiktok_post dari Claude, ChatGPT, atau platform Anda sendiri, sekarang atau pada tanggal dan waktu hingga 90 hari ke depan, dengan setiap postingan yang antre tampil di layar Posts hingga tayang.
Scope yang didefinisikan TikTok untuk membagikan konten ke akun creator sebagai draf untuk diedit dan diposting lebih lanjut di TikTok.
Jumlah maksimum pembagian tertunda yang diizinkan Content Posting API dalam periode 24 jam, batas yang ditetapkan TikTok untuk mengurangi spam.
Status /business/publish/status/ melaporkan setelah draf diunggah dan TikTok telah memberi notifikasi ke kotak masuk creator.
Permintaan yang dapat dikirim setiap user access token ke endpoint unggah Content Posting API.
Apa yang terjadi pada field post_info lainnya ketika upload_to_draft bernilai true pada /business/video/publish/.
Apa perbedaan draf dengan postingan langsung?
Pada siapa yang menekan tombol Posting. Postingan langsung tayang setelah TikTok selesai memprosesnya; draf masuk ke kotak masuk TikTok creator, dan baru dipublikasikan ketika creator membukanya, mengeditnya sesuka hati, lalu memposting. Perbedaan ini berlaku di kedua API posting TikTok:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Bagaimana Content Posting API mengunggah draf?
Dengan POST ke https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, user access token yang memiliki video.upload, dan objek source_info. PULL_FROM_URL meminta TikTok mengambil video dari domain atau awalan URL yang telah diverifikasi aplikasi; FILE_UPLOAD mengembalikan upload_url, tempat file dikirim secara bertahap dengan permintaan PUT. publish_id yang dikembalikan dikirim ke /v2/post/publish/status/fetch/, foto menggunakan /v2/post/publish/content/init/ dengan post_mode diatur ke MEDIA_UPLOAD, dan TikTok meminta aplikasi memberi tahu pengguna untuk membuka notifikasi kotak masuk guna melanjutkan pengeditan di TikTok:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Batasan apa yang berlaku untuk draf Content Posting API?
TikTok mendokumentasikannya pada referensi unggah. Setiap batasan dikembalikan oleh panggilan init ketika berlaku:
- Draf tertunda: paling banyak 5 pembagian tertunda dalam periode 24 jam; melewati itu,
spam_risk_too_many_pending_sharedengan HTTP 403. - Permintaan: 6 per menit per user access token, lalu
rate_limit_exceededdengan HTTP 429. - Scope: token tanpa video.upload menerima
scope_not_authorizeddengan HTTP 401. - Media:
PULL_FROM_URLdari domain atau awalan yang belum diverifikasi aplikasi menghasilkanurl_ownership_unverifieddengan HTTP 403.
Bagaimana API for Business mengunggah draf?
Dengan endpoint publikasinya dan satu field tambahan di post_info. Pada /business/video/publish/, upload_to_draft yang diatur ke true mengirim video sebagai draf, dan TikTok mengabaikan field post_info lainnya; pada /business/photo/publish/, is_draft hanya mempertahankan judul dan keterangan. Keduanya memerlukan video.upload pada token akun, yang ditampilkan oleh /tt_user/token_info/get/, dan tanpa itu pemilik menyetujui unggah draf dengan mengotorisasi ulang aplikasi. Media tetap berada di URL yang terverifikasi, statusnya bertuliskan SEND_TO_USER_INBOX, dan creator menemukan draf melalui notifikasi kotak masuk:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'Apa yang dilakukan creator dengan draf?
Menyelesaikannya di TikTok. Notifikasi kotak masuk membuka video atau foto yang diunggah di editor TikTok, tempat creator meninjau, mengedit, lalu memposting. Pada Content Posting API, statusnya berubah dari SEND_TO_USER_INBOX menjadi PUBLISH_COMPLETE setelah creator memposting dari draf, dan TikTok mencatat bahwa satu draf dapat menghasilkan lebih dari satu postingan.
Apakah easyCoexistence mengirim draf?
Tidak: publish_tiktok_post langsung mempublikasikan. Fungsi ini memanggil /business/video/publish/ atau /business/photo/publish/ tanpa upload_to_draft atau is_draft, sehingga postingan tayang setelah TikTok selesai memprosesnya. Untuk menahan postingan agar bisa ditinjau, jadwalkan dengan scheduled_at, dari 1 menit hingga 90 hari ke depan: postingan menunggu di bagian Akan datang pada layar Posts, update_scheduled_post mengubah waktunya, keterangan, atau judul postingan foto, dan cancel_scheduled_post menghentikannya sebelum tayang.
Kesalahan umum
- Meminta video.publish untuk mengirim draf. Draf memerlukan video.upload, scope yang digambarkan TikTok sebagai membagikan konten sebagai draf.
- Menetapkan keterangan pada draf video melalui API for Business. Dengan upload_to_draft bernilai true, TikTok mengabaikan sisa post_info.
- Mengunggah draf lebih cepat daripada creator memposting. Content Posting API berhenti pada 5 pembagian tertunda dalam 24 jam dengan spam_risk_too_many_pending_share.
- Tidak memberi tahu pengguna cara menuju kotak masuk. TikTok meminta aplikasi memberi tahu mereka untuk membuka notifikasi kotak masuk guna menyelesaikan postingan.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah TikTok API menyimpan video sebagai draf?
Bisa. Alur unggah menempatkannya di kotak masuk TikTok creator, tempat creator mengedit dan memposting; token memerlukan scope video.upload.
Di mana draf yang dikirim lewat API muncul?
Di aplikasi TikTok, di balik notifikasi kotak masuk yang membuka video di editor TikTok untuk diselesaikan creator.
Bisakah draf TikTok mempertahankan keterangan saya?
Pada API for Business, draf foto mempertahankan judul dan keterangannya, sedangkan draf video menghapus field post_info lainnya.
Bisakah satu draf TikTok menjadi lebih dari satu postingan?
Bisa. TikTok mencatat bahwa satu draf dapat menghasilkan lebih dari satu postingan, dan pada Content Posting API statusnya berubah menjadi PUBLISH_COMPLETE setelah creator memposting darinya.
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