Slanje videa u nacrte TikTok kreatora preko API-ja
TikTok API-ji šalju video u nacrte kreatora kroz tok upload-a: /v2/post/publish/inbox/video/init/ iz Content Posting API-ja otprema ga pod opsegom video.upload, a TikTok kreatoru šalje obaveštenje u inboxu da ga uredi i objavi u aplikaciji. API for Business radi isto preko upload_to_draft na /business/video/publish/, ili preko is_draft kod foto objava.
easyCoexistence objavljuje TikTok videe i foto objave preko publish_tiktok_post iz Claude-a, ChatGPT-ja ili vaše platforme, odmah ili na zadati datum i vreme do 90 dana unapred, a svaka objava u redu čeka na ekranu Posts dok ne izađe.
Opseg koji TikTok definiše kao deljenje sadržaja na nalog kreatora kao nacrt za dalje uređivanje i objavu u TikToku.
Najviše deljenja na čekanju koje Content Posting API dozvoljava u bilo kom periodu od 24 sata, ograničenje koje TikTok postavlja radi smanjenja spama.
Status /business/publish/status/ prijavljuje kada je nacrt otpremljen i kada je TikTok obavestio inbox kreatora.
Zahtevi koje svaki korisnički access token može poslati upload endpointu Content Posting API-ja.
Šta se dešava sa ostalim poljima post_info kada je upload_to_draft true na /business/video/publish/.
Čime se nacrt razlikuje od direktne objave?
U tome ko pritisne dugme Objavi. Direktna objava postaje javna čim je TikTok obradi; nacrt stiže u TikTok inbox kreatora i objavljuje se tek kada ga kreator otvori, uredi kako želi i objavi. Razlika prolazi kroz oba TikTok API-ja za objavu:
| 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 |
Kako Content Posting API otprema nacrt?
Pozivom POST na https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, sa korisničkim access tokenom koji ima video.upload i objektom source_info. PULL_FROM_URL znači da TikTok preuzima video sa domena ili prefiksa URL-a koji je aplikacija verifikovala; FILE_UPLOAD vraća upload_url, na koji se fajl šalje u delovima PUT zahtevima. Vraćeni publish_id ide na /v2/post/publish/status/fetch/, fotografije koriste /v2/post/publish/content/init/ sa post_mode postavljenim na MEDIA_UPLOAD, a TikTok traži da aplikacije kažu korisnicima da otvore obaveštenje u inboxu kako bi nastavili uređivanje u TikToku:
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/Koja ograničenja važe za nacrte Content Posting API-ja?
TikTok ih navodi u svojoj referenci za upload, a svako se vraća iz init poziva kada važi:
- Nacrti na čekanju: najviše 5 deljenja na čekanju u bilo kom periodu od 24 sata; posle toga
spam_risk_too_many_pending_shareuz HTTP 403. - Zahtevi: 6 u minuti po korisničkom access tokenu, zatim
rate_limit_exceededuz HTTP 429. - Opseg: token bez video.upload dobija
scope_not_authorizeduz HTTP 401. - Mediji:
PULL_FROM_URLsa domena ili prefiksa koji aplikacija nije verifikovala dobijaurl_ownership_unverifieduz HTTP 403.
Kako API for Business otprema nacrt?
Preko svojih endpointa za objavu i jednog dodatnog polja u post_info. Na /business/video/publish/, upload_to_draft postavljen na true šalje video kao nacrt, a TikTok ignoriše ostala polja post_info; na /business/photo/publish/, is_draft zadržava samo naslov i opis. Oba zahtevaju video.upload na tokenu naloga, koji /tt_user/token_info/get/ prikazuje, a ako ga nema, vlasnik odobrava otpremanje nacrta ponovnim autorizovanjem aplikacije. Medijski fajl i dalje stoji na verifikovanom URL-u, status glasi SEND_TO_USER_INBOX, a kreator nacrt pronalazi preko obaveštenja u inboxu:
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
}
}'Šta kreator radi sa nacrtom?
Završava ga u TikToku. Obaveštenje u inboxu otvara otpremljeni video ili fotografije u TikTok uređivaču, gde kreator pregleda i menja sadržaj, pa objavljuje. Kod Content Posting API-ja status prelazi sa SEND_TO_USER_INBOX na PUBLISH_COMPLETE čim kreator objavi iz nacrta, a TikTok napominje da jedan nacrt može dati više od jedne objave.
Da li easyCoexistence šalje nacrte?
Ne: publish_tiktok_post objavljuje. Poziva /business/video/publish/ ili /business/photo/publish/ bez upload_to_draft ili is_draft, pa objava postaje javna čim je TikTok obradi. Da biste objavu zadržali na pregledu, zakažite je preko scheduled_at, od 1 minuta do 90 dana unapred: čeka pod nazivom „Coming up” na ekranu Posts, update_scheduled_post menja njeno vreme, opis ili naslov foto objave, a cancel_scheduled_post je zaustavlja pre objavljivanja.
Česte greške
- Traženje video.publish za slanje nacrta. Nacrti zahtevaju video.upload, opseg koji TikTok opisuje kao deljenje sadržaja kao nacrta.
- Postavljanje opisa na video nacrt kroz API for Business. Uz upload_to_draft na true, TikTok ignoriše ostatak post_info.
- Otpremanje nacrta brže nego što kreatori objavljuju. Content Posting API staje na 5 deljenja na čekanju u 24 sata uz spam_risk_too_many_pending_share.
- Korisnici ostaju bez uputstva za inbox. TikTok traži da aplikacije kažu korisnicima da otvore obaveštenje u inboxu kako bi završili objavu.
Od US$ 9 do US$ 0.75 po povezanom broju mesečno, a cena pada kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Može li TikTok API da sačuva video kao nacrt?
Može. Otpremanje šalje video u TikTok inbox kreatora, gde kreator uređuje i objavljuje; token mora imati opseg video.upload.
Gde se pojavljuje nacrt poslat preko API-ja?
U aplikaciji TikTok, iza obaveštenja u inboxu koje otvara video u TikTok uređivaču da bi ga kreator završio.
Može li TikTok nacrt da zadrži moj opis?
Kod API for Business, foto nacrt zadržava naslov i opis, dok video nacrt odbacuje ostala polja post_info.
Može li jedan TikTok nacrt da postane više objava?
Može. TikTok napominje da jedan nacrt može dati više objava, a kod Content Posting API-ja status prelazi na PUBLISH_COMPLETE čim kreator objavi iz njega.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na