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ă.
Scope-ul prin care TikTok definește partajarea conținutului în contul creatorului ca ciornă, pentru editare și publicare ulterioară în TikTok.
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.
Statusul /business/publish/status/ raportează odată ce o ciornă a fost încărcată și TikTok a notificat inbox-ul creatorului.
Cererile pe care fiecare token de acces al utilizatorului le poate trimite către endpoint-ul de încărcare al Content Posting API.
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 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 |
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:
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_sharecu HTTP 403. - Cereri: 6 pe minut pentru fiecare token de acces al utilizatorului, apoi
rate_limit_exceededcu HTTP 429. - Scope: un token fără video.upload primește
scope_not_authorizedcu HTTP 401. - Media:
PULL_FROM_URLdintr-un domeniu sau prefix pe care aplicația nu l-a verificat primeșteurl_ownership_unverifiedcu 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:
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.
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