Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

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.

video.upload

Opseg koji TikTok definira kao dijeljenje sadržaja na račun kreatora kao nacrt za daljnje uređivanje i objavu u TikToku.

5 pending

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.

SEND_TO_USER_INBOX

Status /business/publish/status/ javlja kada je nacrt učitan i kada je TikTok obavijestio pretinac kreatora.

6 a minute

Zahtjevi koje svaki korisnički pristupni token smije poslati upload krajnjoj točki Content Posting API-ja.

Ignored

Š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 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

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:

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/

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_share uz HTTP 403.
  • Zahtjevi: 6 u minuti po korisničkom pristupnom tokenu, zatim rate_limit_exceeded uz HTTP 429.
  • Opseg: token bez video.upload dobiva scope_not_authorized uz HTTP 401.
  • Mediji: PULL_FROM_URL s domene ili prefiksa koje aplikacija nije potvrdila dobiva url_ownership_unverified uz 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:

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
    }
  }'

Š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.
Radite ovo uz EasyCoexistence

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