Log masukMulakan percubaan percuma
easyCoexistence API rasmi

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.

video.upload

Skop yang ditakrifkan TikTok sebagai perkongsian kandungan ke akaun pencipta sebagai draf untuk disunting dan disiarkan selanjutnya dalam TikTok.

5 pending

Bilangan maksimum perkongsian tertunda yang dibenarkan Content Posting API dalam mana-mana tempoh 24 jam, had yang ditetapkan TikTok bagi mengurangkan spam.

SEND_TO_USER_INBOX

Status /business/publish/status/ melaporkan sebaik sahaja draf dimuat naik dan TikTok telah memberitahu peti masuk pencipta.

6 a minute

Permintaan yang boleh dihantar oleh setiap token akses pengguna ke endpoint muat naik Content Posting API.

Ignored

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 postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent 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:

Upload a video to the creator's inbox from a URL
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_share dengan HTTP 403.
  • Permintaan: 6 setiap minit bagi setiap token akses pengguna, kemudian rate_limit_exceeded dengan HTTP 429.
  • Skop: token tanpa video.upload menerima scope_not_authorized dengan HTTP 401.
  • Media: PULL_FROM_URL daripada domain atau awalan yang tidak disahkan oleh aplikasi menerima url_ownership_unverified dengan 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:

Send a video to the creator's drafts on the API for Business
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.
Menggunakan EasyCoexistence untuk ini

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