Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Kako proveriti status objave na TikToku preko API-ja

TikTok objavljuje API objave asinhrono: poziv za objavu vraća share_id, a GET /business/publish/status/ sa tim ID-jem kao publish_id pokazuje u kom je stanju objava. Status glasi PROCESSING_DOWNLOAD dok TikTok preuzima fajl, PUBLISH_COMPLETE kada objava prođe moderaciju i bude objavljena, ili FAILED sa razlogom, na primer frame_rate_check_failed.

easyCoexistence objavljuje na TikToku alatom publish_tiktok_post i prati svaku objavu alatom get_tiktok_publish_status, iz Claudea, ChatGPT-ja ili vašeg koda, tako da vaš AI vidi TikTokov status i razlog neuspeha onakav kakav je trenutno.

3 min

Koliko ID-jevi objava mogu da kasne posle PUBLISH_COMPLETE; TikTok preporučuje ponovnu proveru posle tri minuta ako nedostaju.

30 min

Opšta procena TikToka za preuzimanje fajla objave od 1 GB; stvarno vreme zavisi od veličine i mreže.

2 min

Uobičajeno najduže čekanje, posle završetka otpremanja, da objava postane javna; ručna moderacija može da traje duže.

1 hour

Vremensko ograničenje za preuzimanje, posle kog TikTok objavu označi kao neuspelu sa video_pull_failed ili photo_pull_failed.

Zašto treba pratiti TikTok objavu?

Zato što TikTok objavljuje u pozadini. Poziv za objavu pokreće zadatak i odmah vraća share_id; TikTok zatim preuzima fajl sa svog URL-a, proverava format, sprovodi moderaciju i čini objavu javnom. Objava može da ne uspe i nakon što je sam poziv uspešno prošao.

Koji statusi postoje?

GET /business/publish/status/ prima business_id naloga i share_id kao publish_id i vraća jedan od četiri statusa:

  • PROCESSING_DOWNLOAD: TikTok preuzima sadržaj sa svog URL-a.
  • PUBLISH_COMPLETE: objava je prošla moderaciju i objavljena je; polje post_ids je prikazuje čim bude javno vidljiva.
  • FAILED: objavljivanje je prekinuto, a reason objašnjava zašto.
  • SEND_TO_USER_INBOX: nacrt je otpremljen, a TikTok je obavestio inbox kreatora; važi samo za nacrte.

Koliko traje objavljivanje?

TikTok ne navodi fiksno vreme. Preuzimanje zavisi od veličine fajla i mreže, a opšta procena TikToka je da je 30 minuta dovoljno za fajl od 1 GB, uz sat kao gornju granicu. Posle toga objava se obično javno prikaže za 2 minuta, ili kasnije ako treba ručna moderacija, a njen ID objave može da se pojavi u statusu još do tri minuta.

Šta znače razlozi neuspeha?

reason navodi šta je zaustavilo objavu. Neki znače da fajl treba promeniti, a drugi da ponovni pokušaj može da uspe:

  • file_format_check_failed, duration_check_failed, frame_rate_check_failed, picture_size_check_failed: fajl krši pravilo formata, a TikTok ne dozvoljava ponovni pokušaj.
  • video_pull_failed, photo_pull_failed: TikTok nije mogao da preuzme fajl ili nije stigao u roku od sata; ponovite kada URL bude javno dostupan.
  • internal: deo TikTokove usluge nije bio dostupan, a ponovni pokušaj je u redu.
  • spam_risk_too_many_posts, spam_risk, spam_risk_text: TikTok je zaustavio objavu zbog obima, ponašanja ili sadržaja opisa.
  • auth_removed: nalog je povukao pristup aplikacije tokom obrade, a TikTok savetuje da se ne pokušava ponovo.
  • spam_risk_user_banned_from_posting: nalogu je zabranjeno da pravi nove objave.

Čemu služi ID objave?

Da se objava kasnije pronađe. TikTokova referenca prosleđuje ID-jeve objava na /business/video/list/ u polju filters.video_ids da bi pročitala metrike objava. Pozivi za komentare, sa svoje strane, uzimaju item_id objave iz liste videa naloga kao video_id, što je i ono što alati easyCoexistence za komentare uzimaju kao post_id.

Kako easyCoexistence prati objavu?

publish_tiktok_post vraća TikTokov share_id uz napomenu da TikTok obrađuje objavu, a get_tiktok_publish_status uzima taj share_id i vraća TikTokov status onakav kakav je trenutno, sa razlogom kada postoji. Zamolite svoj AI da ponovo proveri posle nekoliko minuta, a ne odmah.

Česte greške

  • Ponovno objavljivanje zato što ništa nije bilo vidljivo. Prvi poziv je samo pokrenuo zadatak, pa proverite njegov status pre nego što objavu pošaljete ponovo.
  • Tretiranje PUBLISH_COMPLETE bez post_ids kao greške. ID-jevi mogu da kasne do tri minuta, pa proverite ponovo tada.
  • Ponovni pokušaj neuspeha formata istim fajlom. file_format_check_failed i ostale provere traže ispravljen fajl.
  • Gašenje URL-a tokom preuzimanja. TikTok objavu označava sa video_pull_failed ili photo_pull_failed kada ne može da preuzme fajl.
Ovo radite uz EasyCoexistence

Od US$ 9 do US$ 0.75 po vezi mesečno, uz smanjenje cene kako dodajete veze, sa prva 3 dana besplatno.

Često postavljana pitanja

Šta je share_id na TikToku?

ID zadatka objave, koji vraćaju endpointi za objavu videa i fotografija. U pozivu za status prosleđuje se kao publish_id.

Postoji li webhook za status objave na TikToku?

Da. Aplikacija pretplaćena sa event_type VIDEO preko /business/webhook/update/ prima događaje objavljivanja TikTok objava, kao što je post.publish.failed sa razlogom i publish_id, umesto ponovljenih provera statusa.

Zašto objavljena TikTok objava još nema ID objave?

TikTok može da treba do tri minuta posle PUBLISH_COMPLETE da vrati post_ids, a vraća ih samo za javno vidljive objave.

Može li neuspela TikTok objava da se ponovi?

Zavisi od razloga. Greške preuzimanja i interne greške mogu da se ponove; greške formata, trajanja, brzine kadrova i veličine slike traže ispravljen fajl.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na