Pagpapadala ng video sa drafts ng TikTok creator gamit ang API
Nagpapadala ang TikTok API ng video sa drafts ng creator gamit ang upload flow: ang /v2/post/publish/inbox/video/init/ ng Content Posting API ang nag-uupload nito sa ilalim ng video.upload scope, at nagpapadala ang TikTok ng inbox notification sa creator para i-edit at i-post ito sa app. Ginagawa rin ito ng API for Business gamit ang upload_to_draft sa /business/video/publish/, o ang is_draft para sa photo posts.
Nagpo-publish ang easyCoexistence ng mga TikTok video at photo post gamit ang publish_tiktok_post mula sa Claude, ChatGPT o sa sarili ninyong platform, ngayon na o sa itinakdang petsa at oras hanggang 90 araw nang maaga, at nakikita ang bawat nakapilang post sa Posts screen hanggang sa lumabas ito.
Scope na inilalarawan ng TikTok bilang pagbabahagi ng content sa account ng creator bilang draft, para mai-edit at ma-post pa sa TikTok.
Pinakamaraming pending shares na pinapayagan ng Content Posting API sa loob ng anumang 24-hour period, isang limitasyong itinakda ng TikTok para mabawasan ang spam.
Nag-uulat ang status na /business/publish/status/ kapag na-upload na ang draft at naabisuhan na ng TikTok ang inbox ng creator.
Mga request na maaaring ipadala ng bawat user access token sa upload endpoint ng Content Posting API.
Ano ang mangyayari sa iba pang post_info fields kapag true ang upload_to_draft sa /business/video/publish/.
Ano ang pagkakaiba ng draft sa direct post?
Nasa kung sino ang pumipindot ng Post. Direktang lumalabas ang direct post kapag naproseso na ito ng TikTok; ang draft naman ay napupunta sa TikTok inbox ng creator, at ipo-post lang ito kapag binuksan ng creator, in-edit ayon sa gusto niya, at saka na-post. Makikita ang pagkakaibang ito sa parehong posting API ng 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 |
Paano nag-upload ng draft ang Content Posting API?
Gamit ang POST sa https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, isang user access token na may video.upload, at source_info object. Sa PULL_FROM_URL, kinukuha ng TikTok ang video mula sa domain o URL prefix na na-verify ng app; sa FILE_UPLOAD naman, nagbabalik ito ng upload_url kung saan ipinapadala ang file sa mga chunk gamit ang PUT requests. Ang publish_id na ibinalik ay napupunta sa /v2/post/publish/status/fetch/, ang photos ay gumagamit ng /v2/post/publish/content/init/ na may post_mode na MEDIA_UPLOAD, at hinihiling ng TikTok sa mga app na sabihan ang mga user na buksan ang inbox notification para magpatuloy sa pag-edit sa 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/Anong mga limitasyon ang nalalapat sa Content Posting API drafts?
Dinodokumento ito ng TikTok sa upload reference nito, at ibinabalik ng init call ang bawat isa kapag nalalapat:
- Pending drafts: hanggang 5 pending shares sa loob ng anumang 24-hour period; lampas doon,
spam_risk_too_many_pending_sharena may HTTP 403. - Requests: 6 kada minuto bawat user access token, pagkatapos ay
rate_limit_exceededna may HTTP 429. - Scope: ang token na walang video.upload ay makakakuha ng
scope_not_authorizedna may HTTP 401. - Media: ang
PULL_FROM_URLmula sa domain o prefix na hindi pa na-verify ng app ay makakakuha ngurl_ownership_unverifiedna may HTTP 403.
Paano nag-upload ng draft ang API for Business?
Gamit ang publishing endpoints nito at isa pang field sa post_info. Sa /business/video/publish/, kapag itinakda sa true ang upload_to_draft, ipinapadala ang video bilang draft at binabalewala ng TikTok ang iba pang post_info fields; sa /business/photo/publish/, tanging ang title at caption ang pinapanatili ng is_draft. Parehong kailangan ang video.upload sa token ng account, na nakalista sa /tt_user/token_info/get/, at kung wala ito, inaaprubahan ng may-ari ang pag-upload ng draft sa pamamagitan ng muling pag-authorize sa app. Nananatili pa rin ang media sa verified URL, ang status ay nagpapakita ng SEND_TO_USER_INBOX, at makikita ng creator ang draft sa pamamagitan ng inbox notification:
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
}
}'Ano ang ginagawa ng creator sa draft?
Tinatapos ito sa TikTok. Binubuksan ng inbox notification ang na-upload na video o mga larawan sa editor ng TikTok, kung saan sinusuri at ini-edit ng creator ang mga ito at saka ini-post. Sa Content Posting API, lumilipat ang status mula SEND_TO_USER_INBOX patungong PUBLISH_COMPLETE kapag na-post na ng creator mula sa draft, at nagsasaad ang TikTok na maaaring makagawa ng higit sa isang post ang isang draft.
Nagpapadala ba ng drafts ang easyCoexistence?
Hindi: nagpo-publish ang publish_tiktok_post. Tumatawag ito sa /business/video/publish/ o /business/photo/publish/ nang walang upload_to_draft o is_draft, kaya direktang lumalabas ang post kapag naproseso na ito ng TikTok. Para pigilan muna ang post para sa review, i-schedule ito gamit ang scheduled_at, mula 1 minuto hanggang 90 araw nang maaga: nakapila ito sa ilalim ng "Coming up" sa Posts screen, binabago ng update_scheduled_post ang oras, caption o title ng photo post, at ihinihinto ng cancel_scheduled_post ang post bago ito lumabas.
Mga karaniwang pagkakamali
- Paghingi ng video.publish para magpadala ng drafts. Kailangan ng drafts ang video.upload, ang scope na inilalarawan ng TikTok bilang pagbabahagi ng content bilang draft.
- Pagtatakda ng caption sa video draft sa pamamagitan ng API for Business. Kapag true ang upload_to_draft, binabalewala ng TikTok ang iba pang bahagi ng post_info.
- Pag-upload ng drafts nang mas mabilis kaysa sa pag-post ng creators. Humihinto ang Content Posting API sa 5 pending shares sa loob ng 24 na oras, na may spam_risk_too_many_pending_share.
- Pag-iwan sa mga user nang walang gabay papunta sa inbox. Hinihiling ng TikTok sa mga app na sabihan sila na buksan ang inbox notification para matapos ang post.
US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nagdadagdag ng koneksyon, na may unang 3 araw na free trial.
Mga madalas itanong
Maaari bang i-save ng TikTok API ang video bilang draft?
Oo. Inilalagay ng upload flow ang video sa TikTok inbox ng creator, kung saan ito ini-edit at ipino-post ng creator; kailangan ng token ang video.upload scope.
Saan lumalabas ang draft na ipinadala sa pamamagitan ng API?
Sa TikTok app, sa likod ng inbox notification na nagbubukas ng video sa editor ng TikTok para tapusin ito ng creator.
Maaari bang mapanatili ng TikTok draft ang caption ko?
Sa API for Business, pinapanatili ng photo draft ang title at caption nito, samantalang binabalewala ng video draft ang iba pang post_info fields.
Maaari bang maging higit sa isang post ang isang TikTok draft?
Oo. Nagsasaad ang TikTok na maaaring makagawa ng higit sa isang post ang isang draft, at sa Content Posting API, lumilipat ang status sa PUBLISH_COMPLETE kapag na-post na ng creator mula rito.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong