Slanje videa u TikTok pretinac nacrta putem API-ja
TikTok API-ji šalju video u nacrte kreatora putem toka učitavanja: /v2/post/publish/inbox/video/init/ iz Content Posting API-ja učitava video pod opsegom video.upload, a TikTok kreatoru šalje obavijest u pretincu da ga uredi i objavi u aplikaciji. API for Business radi isto s upload_to_draft na /business/video/publish/, odnosno s is_draft kod fotografija.
easyCoexistence objavljuje TikTok videe i fotografske objave putem publish_tiktok_post iz Claudea, ChatGPT-ja ili vlastite platforme, odmah ili na zadani datum i vrijeme do 90 dana unaprijed, a svaka objava u redu čeka na zaslonu Objave dok ne izađe.
Opseg koji TikTok definira kao dijeljenje sadržaja na račun kreatora kao nacrt za daljnje uređivanje i objavu u TikToku.
Najviše čekajućih dijeljenja koja Content Posting API dopušta unutar bilo kojeg razdoblja od 24 sata, ograničenje koje TikTok postavlja radi smanjenja neželjene pošte.
Status /business/publish/status/ javlja kada je nacrt učitan i kada je TikTok obavijestio pretinac kreatora.
Zahtjevi koje svaki korisnički pristupni token smije poslati upload krajnjoj točki Content Posting API-ja.
Što se događa s ostalim poljima post_info kada je upload_to_draft na /business/video/publish/ postavljen na true.
Po čemu se nacrt razlikuje od izravne objave?
Po tome tko pritisne Objavi. Izravna objava postaje javna čim je TikTok obradi; nacrt završava u TikTok pretincu kreatora i objavljuje se tek kada kreator otvori nacrt, uredi ga kako želi i objavi. Razlika prolazi kroz oba TikTokova 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 učitava nacrt?
Zahtjevom POST na https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, uz korisnički pristupni token koji ima video.upload i objekt source_info. PULL_FROM_URL znači da TikTok preuzima video s domene ili prefiksa URL-a koji je aplikacija potvrdila; FILE_UPLOAD vraća upload_url, na koji se datoteka šalje u dijelovima zahtjevima PUT. Vraćeni publish_id ide na /v2/post/publish/status/fetch/, fotografije koriste /v2/post/publish/content/init/ s post_mode postavljenim na MEDIA_UPLOAD, a TikTok traži od aplikacija da kažu korisnicima da otvore obavijest u pretincu 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 se ograničenja primjenjuju na nacrte Content Posting API-ja?
TikTok ih navodi u referenci za učitavanje, a svako se vraća u pozivu init kada se primijeni:
- Čekajući nacrti: najviše 5 čekajućih dijeljenja unutar bilo kojeg razdoblja od 24 sata; nakon toga
spam_risk_too_many_pending_shareuz HTTP 403. - Zahtjevi: 6 u minuti po korisničkom pristupnom tokenu, zatim
rate_limit_exceededuz HTTP 429. - Opseg: token bez video.upload dobiva
scope_not_authorizeduz HTTP 401. - Mediji:
PULL_FROM_URLs domene ili prefiksa koje aplikacija nije potvrdila dobivaurl_ownership_unverifieduz HTTP 403.
Kako API for Business učitava nacrt?
Putem svojih krajnjih točaka za objavu i jednog dodatnog polja u post_info. Na /business/video/publish/ postavljanje upload_to_draft na true šalje video kao nacrt, a TikTok zanemaruje ostala polja post_info; na /business/photo/publish/ is_draft zadržava samo naslov i opis. Oboje zahtijeva video.upload na tokenu računa, što /tt_user/token_info/get/ prikazuje, a bez njega vlasnik odobrava učitavanje nacrta ponovnim ovlaštenjem aplikacije. Medij i dalje mora biti na potvrđenom URL-u, status glasi SEND_TO_USER_INBOX, a kreator nacrt pronalazi putem obavijesti u pretincu:
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
}
}'Što kreator radi s nacrtom?
Dovršava ga u TikToku. Obavijest u pretincu otvara učitani video ili fotografije u TikTokovu uređivaču, gdje kreator pregledava i uređuje sadržaj te ga objavljuje. Kod Content Posting API-ja status prelazi iz SEND_TO_USER_INBOX u PUBLISH_COMPLETE kada kreator objavi iz nacrta, a TikTok napominje da jedan nacrt može dati više objava.
Šalje li easyCoexistence 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 za pregled, zakažite je pomoću scheduled_at, od 1 minute do 90 dana unaprijed: čeka pod Predstoji na zaslonu Objave, update_scheduled_post mijenja vrijeme, opis ili naslov fotografske objave, a cancel_scheduled_post je zaustavlja prije izlaska.
Uobičajene pogreške
- Traženje video.publish za slanje nacrta. Nacrtima je potreban video.upload, opseg koji TikTok opisuje kao dijeljenje sadržaja kao nacrta.
- Postavljanje opisa na video nacrt putem API for Business. Uz upload_to_draft na true TikTok zanemaruje ostatak post_info.
- Učitavanje nacrta brže nego što kreatori objavljuju. Content Posting API staje na 5 čekajućih dijeljenja u 24 sata uz spam_risk_too_many_pending_share.
- Korisnicima se ne kaže gdje je pretinac. TikTok traži od aplikacija da im kažu da otvore obavijest u pretincu kako bi dovršili objavu.
US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, s prva 3 dana besplatno.
Često postavljana pitanja
Može li TikTok API spremiti video kao nacrt?
Da. Tok učitavanja stavlja ga u TikTok pretinac kreatora, gdje ga kreator uređuje i objavljuje; token treba opseg video.upload.
Gdje se nacrt poslan putem API-ja pojavljuje?
U aplikaciji TikTok, iza obavijesti u pretincu koja video otvara u TikTokovu uređivaču da ga kreator dovrši.
Može li TikTok nacrt zadržati moj opis?
Kod API for Business fotografski nacrt zadržava naslov i opis, dok video nacrt odbacuje ostala polja post_info.
Može li jedan TikTok nacrt postati više objava?
Da. TikTok napominje da jedan nacrt može dati više objava, a kod Content Posting API-ja status prelazi u PUBLISH_COMPLETE kada kreator objavi iz njega.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na