Menghantar video ke draf pencipta TikTok melalui API
API TikTok menghantar video ke draf pencipta melalui aliran muat naik: /v2/post/publish/inbox/video/init/ dalam Content Posting API memuat naik video di bawah skop video.upload, dan TikTok menghantar pemberitahuan peti masuk kepada pencipta untuk menyunting dan menyiarkannya dalam aplikasi. API for Business melakukan perkara yang sama dengan upload_to_draft pada /business/video/publish/, atau is_draft bagi siaran foto.
easyCoexistence menyiarkan video dan siaran foto TikTok dengan publish_tiktok_post daripada Claude, ChatGPT atau platform anda sendiri, sekarang atau pada tarikh dan masa sehingga 90 hari ke hadapan, dengan setiap siaran dalam barisan dipaparkan pada skrin Siaran sehingga disiarkan.
Skop yang ditakrifkan TikTok sebagai perkongsian kandungan ke akaun pencipta sebagai draf untuk disunting dan disiarkan selanjutnya dalam TikTok.
Bilangan maksimum perkongsian tertunda yang dibenarkan Content Posting API dalam mana-mana tempoh 24 jam, had yang ditetapkan TikTok bagi mengurangkan spam.
Status /business/publish/status/ melaporkan sebaik sahaja draf dimuat naik dan TikTok telah memberitahu peti masuk pencipta.
Permintaan yang boleh dihantar oleh setiap token akses pengguna ke endpoint muat naik Content Posting API.
Apa yang berlaku kepada medan post_info yang lain apabila upload_to_draft bernilai true pada /business/video/publish/.
Apakah beza draf dengan siaran terus?
Dari segi siapa yang menekan Siarkan. Siaran terus dipaparkan sebaik sahaja TikTok memprosesnya; draf pula masuk ke peti masuk TikTok pencipta, dan hanya disiarkan apabila pencipta membukanya, menyuntingnya mengikut kehendaknya dan menyiarkannya. Perbezaan ini terdapat dalam kedua-dua API siaran 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 memuat naik draf?
Dengan permintaan POST ke https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, token akses pengguna yang memiliki video.upload, dan objek source_info. PULL_FROM_URL meminta TikTok mengambil video daripada domain atau awalan URL yang telah disahkan oleh aplikasi; FILE_UPLOAD mengembalikan upload_url, ke mana fail dihantar secara ketulan melalui permintaan PUT. publish_id yang dikembalikan dihantar ke /v2/post/publish/status/fetch/, foto menggunakan /v2/post/publish/content/init/ dengan post_mode ditetapkan kepada MEDIA_UPLOAD, dan TikTok meminta aplikasi memberitahu pengguna supaya membuka pemberitahuan peti masuk untuk meneruskan penyuntingan dalam 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/Apakah had yang terpakai ke atas draf Content Posting API?
TikTok mendokumentasikannya pada rujukan muat naiknya, setiap satu dikembalikan oleh panggilan init apabila ia terpakai:
- Draf tertunda: paling banyak 5 perkongsian tertunda dalam mana-mana tempoh 24 jam; melebihi itu,
spam_risk_too_many_pending_sharedengan HTTP 403. - Permintaan: 6 setiap minit bagi setiap token akses pengguna, kemudian
rate_limit_exceededdengan HTTP 429. - Skop: token tanpa video.upload menerima
scope_not_authorizeddengan HTTP 401. - Media:
PULL_FROM_URLdaripada domain atau awalan yang tidak disahkan oleh aplikasi menerimaurl_ownership_unverifieddengan HTTP 403.
Bagaimana API for Business memuat naik draf?
Dengan endpoint penerbitannya dan satu lagi medan dalam post_info. Pada /business/video/publish/, upload_to_draft ditetapkan kepada true untuk menghantar video sebagai draf, dan TikTok mengabaikan medan post_info yang lain; pada /business/photo/publish/, is_draft hanya mengekalkan tajuk dan kapsyen. Kedua-duanya memerlukan video.upload pada token akaun, yang disenaraikan oleh /tt_user/token_info/get/, dan tanpanya pemilik meluluskan muat naik draf dengan membenarkan aplikasi semula. Media masih berada pada URL yang disahkan, status menunjukkan SEND_TO_USER_INBOX, dan pencipta mendapati draf melalui pemberitahuan peti 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 pencipta dengan draf itu?
Menyiapkannya dalam TikTok. Pemberitahuan peti masuk membuka video atau foto yang dimuat naik dalam penyunting TikTok, tempat pencipta menyemak dan menyunting, kemudian menyiarkannya. Pada Content Posting API, status bertukar daripada SEND_TO_USER_INBOX kepada PUBLISH_COMPLETE sebaik sahaja pencipta menyiarkan daripada draf, dan TikTok menyatakan bahawa satu draf boleh menghasilkan lebih daripada satu siaran.
Adakah easyCoexistence menghantar draf?
Tidak: publish_tiktok_post menyiarkan terus. Ia memanggil /business/video/publish/ atau /business/photo/publish/ tanpa upload_to_draft atau is_draft, jadi siaran dipaparkan sebaik sahaja TikTok memprosesnya. Untuk menahan siaran bagi semakan, jadualkannya dengan scheduled_at, dari 1 minit hingga 90 hari ke hadapan: ia menunggu di bawah Akan datang pada skrin Siaran, update_scheduled_post menukar masanya, kapsyen atau tajuk siaran foto, dan cancel_scheduled_post menghentikannya sebelum ia disiarkan.
Kesilapan biasa
- Meminta video.publish untuk menghantar draf. Draf memerlukan video.upload, skop yang digambarkan TikTok sebagai perkongsian kandungan sebagai draf.
- Menetapkan kapsyen pada draf video melalui API for Business. Dengan upload_to_draft bernilai true, TikTok mengabaikan baki post_info.
- Memuat naik draf lebih pantas daripada pencipta menyiarkannya. Content Posting API berhenti pada 5 perkongsian tertunda dalam 24 jam dengan spam_risk_too_many_pending_share.
- Tidak memberikan pengguna petunjuk ke peti masuk. TikTok meminta aplikasi memberitahu mereka supaya membuka pemberitahuan peti masuk untuk menyelesaikan siaran.
US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari.
Soalan lazim
Bolehkah API TikTok menyimpan video sebagai draf?
Boleh. Aliran muat naik meletakkannya dalam peti masuk TikTok pencipta, tempat pencipta menyunting dan menyiarkannya; token memerlukan skop video.upload.
Di manakah draf yang dihantar melalui API muncul?
Dalam aplikasi TikTok, di sebalik pemberitahuan peti masuk yang membuka video dalam penyunting TikTok untuk diselesaikan oleh pencipta.
Bolehkah draf TikTok mengekalkan kapsyen saya?
Pada API for Business, draf foto mengekalkan tajuk dan kapsyennya, manakala draf video menggugurkan medan post_info yang lain.
Bolehkah satu draf TikTok menjadi lebih daripada satu siaran?
Boleh. TikTok menyatakan bahawa satu draf boleh menghasilkan lebih daripada satu siaran, dan pada Content Posting API status bertukar kepada PUBLISH_COMPLETE sebaik sahaja pencipta menyiarkan daripadanya.
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