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

Cum verificați starea publicării unei postări TikTok prin API

TikTok publică postările prin API în mod asincron: apelul de publicare returnează un share_id, iar GET /business/publish/status/ cu acest ID ca publish_id arată unde se află postarea. Starea este PROCESSING_DOWNLOAD cât timp TikTok descarcă fișierul, PUBLISH_COMPLETE după ce postarea a trecut moderarea și a fost publicată, sau FAILED, cu un motiv precum frame_rate_check_failed.

easyCoexistence publică pe TikTok cu publish_tiktok_post și urmărește fiecare postare cu get_tiktok_publish_status, din Claude, ChatGPT sau din propriul cod, astfel încât AI-ul dumneavoastră să vadă starea TikTok și orice motiv de eșec așa cum sunt acum.

3 min

Cât durează până apar ID-urile postărilor după PUBLISH_COMPLETE; TikTok recomandă să reîncercați după trei minute dacă lipsesc.

30 min

Estimarea generală a TikTok pentru descărcarea unui fișier de postare de 1 GB; timpul real depinde de dimensiune și de rețea.

2 min

Cea mai lungă așteptare obișnuită, după finalizarea încărcării, până când o postare devine publică; moderarea manuală poate dura mai mult.

1 hour

Timpul limită de descărcare după care TikTok eșuează o postare cu video_pull_failed sau photo_pull_failed.

De ce trebuie urmărită o postare TikTok?

Pentru că TikTok o publică în fundal. Apelul de publicare pornește o sarcină și returnează imediat un share_id; apoi TikTok descarcă fișierul de la URL-ul său, verifică formatul, rulează moderarea și face postarea publică. O postare poate eșua și după ce apelul în sine a reușit.

Ce stări există?

GET /business/publish/status/ primește business_id-ul contului și share_id-ul ca publish_id și returnează una dintre cele patru stări:

  • PROCESSING_DOWNLOAD: TikTok descarcă conținutul de la URL-ul său.
  • PUBLISH_COMPLETE: postarea a trecut moderarea și a fost publicată; post_ids o listează odată ce este vizibilă public.
  • FAILED: publicarea s-a oprit, iar reason explică motivul.
  • SEND_TO_USER_INBOX: o ciornă a fost încărcată, iar TikTok a notificat căsuța de intrare a creatorului; se aplică doar ciornelor.

Cât durează publicarea?

TikTok nu oferă un timp fix. Descărcarea depinde de dimensiunea fișierului și de rețea, iar estimarea generală a TikTok este că 30 de minute sunt suficiente pentru un fișier de 1 GB, cu o oră ca limită. După aceea, o postare devine de obicei publică în 2 minute sau mai târziu, dacă necesită moderare manuală, iar ID-ul postării poate avea nevoie de până la încă trei minute ca să apară în stare.

Ce înseamnă motivele eșecului?

reason indică ce a oprit postarea. Unele înseamnă că fișierul trebuie schimbat, altele că o reîncercare poate reuși:

  • file_format_check_failed, duration_check_failed, frame_rate_check_failed, picture_size_check_failed: fișierul încalcă o regulă de format, iar TikTok marchează aceste motive ca neputând fi reîncercate.
  • video_pull_failed, photo_pull_failed: TikTok nu a putut descărca fișierul sau nu a reușit în limita de o oră; reîncercați după ce URL-ul este accesibil public.
  • internal: o parte din serviciul TikTok a fost indisponibilă, iar o reîncercare este în regulă.
  • spam_risk_too_many_posts, spam_risk, spam_risk_text: TikTok a oprit postarea din cauza volumului, comportamentului sau textului descrierii.
  • auth_removed: contul a retras accesul aplicației în timpul procesării, iar TikTok spune să nu reîncercați.
  • spam_risk_user_banned_from_posting: contului îi este interzis să mai creeze postări noi.

La ce folosește ID-ul postării?

Pentru a găsi postarea ulterior. Referința TikTok trece ID-urile postărilor către /business/video/list/ în filters.video_ids ca să citească metricile postărilor. Apelurile pentru comentarii, la rândul lor, primesc item_id-ul unei postări din lista de videoclipuri a contului ca video_id, iar acesta este și parametrul pe care îl primesc uneltele de comentarii ale easyCoexistence ca post_id.

Cum urmărește easyCoexistence o postare?

publish_tiktok_post returnează share_id-ul TikTok cu o notă că TikTok procesează postarea, iar get_tiktok_publish_status primește acest share_id și returnează starea TikTok așa cum este în acel moment, cu motivul atunci când există unul. Cereți AI-ului să verifice din nou după câteva minute, nu imediat.

Greșeli frecvente

  • Republicarea pentru că nu a apărut nimic încă. Primul apel doar a pornit sarcina, așa că verificați starea acesteia înainte de a trimite din nou postarea.
  • Tratarea PUBLISH_COMPLETE fără post_ids ca pe o eroare. ID-urile pot întârzia până la trei minute în plus, așa că verificați din nou atunci.
  • Reîncercarea unui eșec de format cu același fișier. file_format_check_failed și celelalte eșecuri de verificare necesită un fișier corectat.
  • Scoaterea URL-ului de pe internet în timpul descărcării. TikTok eșuează postarea cu video_pull_failed sau photo_pull_failed când nu poate prelua fișierul.
Faceți acest lucru cu EasyCoexistence

De la US$ 9 la US$ 0,75 pe conexiune pe lună, cu scădere pe măsură ce adăugați conexiuni, cu prima perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Ce este share_id-ul pe TikTok?

ID-ul unei sarcini de publicare, returnat de endpoint-urile de publicare pentru videoclipuri și fotografii. Se transmite în apelul de stare ca publish_id.

Există un webhook pentru starea publicării pe TikTok?

Da. O aplicație abonată cu event_type VIDEO prin /business/webhook/update/ primește evenimentele de publicare ale postărilor TikTok, cum ar fi post.publish.failed, cu motivul și publish_id-ul, în locul verificărilor repetate ale stării.

De ce o postare publicată nu are încă un ID?

TikTok poate avea nevoie de până la trei minute după PUBLISH_COMPLETE pentru a returna post_ids și le returnează doar pentru postările vizibile public.

Poate fi reîncercată o postare TikTok eșuată?

Depinde de motiv. Eșecurile de descărcare și cele interne pot fi reîncercate; eșecurile de format, durată, rată de cadre și dimensiunea imaginii necesită un fișier corectat.

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