Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Trimiterea unui video în ciornele unui creator TikTok prin API

API-urile TikTok trimit un video în ciornele unui creator prin fluxul de încărcare: /v2/post/publish/inbox/video/init/ din Content Posting API îl încarcă sub scope-ul video.upload, iar TikTok îi trimite creatorului o notificare în inbox ca să îl editeze și să îl posteze în aplicație. API for Business face același lucru cu upload_to_draft pe /business/video/publish/ sau cu is_draft la postările foto.

easyCoexistence publică videoclipuri TikTok și postări foto cu publish_tiktok_post din Claude, ChatGPT sau propria platformă, acum sau la o dată și oră de până la 90 de zile înainte, iar fiecare postare programată apare pe ecranul Posts până când pleacă.

video.upload

Scope-ul prin care TikTok definește partajarea conținutului în contul creatorului ca ciornă, pentru editare și publicare ulterioară în TikTok.

5 pending

Cele mai multe partajări în așteptare pe care Content Posting API le permite în orice perioadă de 24 de ore, limită stabilită de TikTok pentru a reduce spamul.

SEND_TO_USER_INBOX

Statusul /business/publish/status/ raportează odată ce o ciornă a fost încărcată și TikTok a notificat inbox-ul creatorului.

6 a minute

Cererile pe care fiecare token de acces al utilizatorului le poate trimite către endpoint-ul de încărcare al Content Posting API.

Ignored

Ce se întâmplă cu celelalte câmpuri post_info când upload_to_draft este true pe /business/video/publish/.

Prin ce se deosebește o ciornă de o postare directă?

Prin cine apasă pe Post. O postare directă devine publică odată ce TikTok a procesat-o; o ciornă ajunge în inbox-ul TikTok al creatorului și este publicată doar când acesta o deschide, o editează cum dorește și o postează. Diferența se regăsește în ambele API-uri de publicare ale 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

Cum încarcă Content Posting API o ciornă?

Printr-un POST către https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, cu un token de acces al utilizatorului care are video.upload și un obiect source_info. PULL_FROM_URL îi cere TikTok să preia videoclipul de pe un domeniu sau prefix de URL verificat de aplicație; FILE_UPLOAD returnează un upload_url, la care fișierul este trimis în bucăți prin cereri PUT. publish_id returnat merge către /v2/post/publish/status/fetch/, fotografiile folosesc /v2/post/publish/content/init/ cu post_mode setat la MEDIA_UPLOAD, iar TikTok cere aplicațiilor să îi spună utilizatorului să deschidă notificarea din inbox pentru a continua editarea în 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/

Ce limite se aplică ciornelor din Content Posting API?

TikTok le documentează în referința de încărcare; fiecare este returnată de apelul de inițializare atunci când se aplică:

  • Ciorne în așteptare: cel mult 5 partajări în așteptare în orice perioadă de 24 de ore; peste această limită, spam_risk_too_many_pending_share cu HTTP 403.
  • Cereri: 6 pe minut pentru fiecare token de acces al utilizatorului, apoi rate_limit_exceeded cu HTTP 429.
  • Scope: un token fără video.upload primește scope_not_authorized cu HTTP 401.
  • Media: PULL_FROM_URL dintr-un domeniu sau prefix pe care aplicația nu l-a verificat primește url_ownership_unverified cu HTTP 403.

Cum încarcă API for Business o ciornă?

Prin endpoint-urile sale de publicare și un câmp în plus în post_info. Pe /business/video/publish/, upload_to_draft setat la true trimite videoclipul ca ciornă, iar TikTok ignoră celelalte câmpuri post_info; pe /business/photo/publish/, is_draft păstrează doar titlul și legenda. Ambele necesită video.upload pe token-ul contului, pe care îl listează /tt_user/token_info/get/, iar fără el proprietarul aprobă încărcarea ciornelor reautorizând aplicația. Media rămâne pe un URL verificat, statusul arată SEND_TO_USER_INBOX, iar creatorul găsește ciorna prin notificarea din inbox:

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

Ce face creatorul cu ciorna?

O finalizează în TikTok. Notificarea din inbox deschide videoclipul sau fotografiile încărcate în editorul TikTok, unde creatorul le verifică, le editează și le postează. În cazul Content Posting API, statusul trece de la SEND_TO_USER_INBOX la PUBLISH_COMPLETE odată ce creatorul postează din ciornă, iar TikTok notează că o singură ciornă poate produce mai mult de o postare.

easyCoexistence trimite ciorne?

Nu: publish_tiktok_post publică. Apelează /business/video/publish/ sau /business/photo/publish/ fără upload_to_draft sau is_draft, astfel că o postare devine publică odată ce TikTok a procesat-o. Pentru a reține o postare până la verificare, programați-o cu scheduled_at, cu un interval de la 1 minut la 90 de zile înainte: așteaptă sub Coming up pe ecranul Posts, update_scheduled_post îi schimbă ora, legenda sau titlul unei postări foto, iar cancel_scheduled_post o oprește înainte să plece.

Greșeli frecvente

  • Cerere de video.publish pentru a trimite ciorne. Ciornele au nevoie de video.upload, scope-ul pe care TikTok îl descrie ca partajare a conținutului ca ciornă.
  • Setarea unei legende pe o ciornă video prin API for Business. Cu upload_to_draft setat la true, TikTok ignoră restul câmpurilor post_info.
  • Încărcarea ciornelor mai repede decât le postează creatorii. Content Posting API se oprește la 5 partajări în așteptare în 24 de ore, cu spam_risk_too_many_pending_share.
  • Neindicarea inbox-ului către utilizatori. TikTok cere aplicațiilor să le spună să deschidă notificarea din inbox pentru a finaliza postarea.
Faceți acest lucru cu EasyCoexistence

De la US$ 9 la US$ 0,75 pe conexiune pe lună, care scade pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Poate API-ul TikTok să salveze un videoclip ca ciornă?

Da. Fluxul de încărcare îl pune în inbox-ul TikTok al creatorului, unde acesta îl editează și îl postează; token-ul are nevoie de scope-ul video.upload.

Unde apare o ciornă trimisă prin API?

În aplicația TikTok, în spatele unei notificări din inbox care deschide videoclipul în editorul TikTok pentru ca creatorul să îl finalizeze.

Poate o ciornă TikTok să păstreze legenda mea?

Pe API for Business, o ciornă foto își păstrează titlul și legenda, în timp ce o ciornă video renunță la celelalte câmpuri post_info.

Poate o singură ciornă TikTok să devină mai multe postări?

Da. TikTok notează că o singură ciornă poate produce mai mult de o postare, iar în Content Posting API statusul trece la PUBLISH_COMPLETE odată ce creatorul postează din ea.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la