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

Kako provjeriti status objave na TikToku putem API-ja

TikTok objavljuje API objave asinkrono: poziv za objavu vraća share_id, a GET /business/publish/status/ s tim ID-jem kao publish_id pokazuje u kojem je stanju objava. Status glasi PROCESSING_DOWNLOAD dok TikTok preuzima datoteku, PUBLISH_COMPLETE kad objava prođe moderaciju i bude objavljena, ili FAILED s razlogom, primjerice frame_rate_check_failed.

easyCoexistence objavljuje na TikTok pomoću publish_tiktok_post i prati svaku objavu pomoću get_tiktok_publish_status, iz Claudea, ChatGPT-ja ili vašeg vlastitog koda, pa vaš AI vidi TikTokov status i razlog neuspjeha kakvi jesu.

3 min

Koliko ID-jevi objava mogu trajati nakon PUBLISH_COMPLETE; TikTok kaže da treba pokušati ponovno nakon tri minute ako nedostaju.

30 min

Opća procjena TikToka za preuzimanje datoteke objave od 1 GB; stvarno vrijeme ovisi o veličini datoteke i mreži.

2 min

Uobičajeno najdulje čekanje, nakon završetka prijenosa, da objava postane javna; ručna moderacija može trajati dulje.

1 hour

Vremensko ograničenje preuzimanja nakon kojeg TikTok objavu označi kao neuspjelu s video_pull_failed ili photo_pull_failed.

Zašto treba pratiti objavu na TikToku?

Zato što je TikTok objavljuje u pozadini. Poziv za objavu pokreće zadatak i odmah vraća share_id; TikTok zatim preuzima datoteku s njezina URL-a, provjerava format, provodi moderaciju i čini objavu javnom. Objava može i dalje neuspjeti iako je sam poziv uspio.

Koji statusi postoje?

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

  • PROCESSING_DOWNLOAD: TikTok preuzima sadržaj s njegova URL-a.
  • PUBLISH_COMPLETE: objava je prošla moderaciju i objavljena je; post_ids je navodi kad je javno vidljiva.
  • FAILED: objavljivanje je zaustavljeno, a reason kazuje zašto.
  • SEND_TO_USER_INBOX: nacrt je učitan i TikTok je obavijestio sanduče kreatora; odnosi se samo na nacrte.

Koliko traje objavljivanje?

TikTok ne navodi fiksno vrijeme. Preuzimanje ovisi o veličini datoteke i mreži; opća procjena TikToka jest da je za datoteku od 1 GB dovoljno 30 minuta, uz sat kao granicu. Nakon toga objava se obično javno prikaže unutar 2 minute, ili kasnije ako treba ručnu moderaciju, a njezin ID objave može se u statusu pojaviti i do tri minute kasnije.

Što znače razlozi neuspjeha?

reason kazuje što je zaustavilo objavu. Neki znače da se datoteka mora promijeniti, a drugi da ponovni pokušaj može uspjeti:

  • file_format_check_failed, duration_check_failed, frame_rate_check_failed, picture_size_check_failed: datoteka krši pravilo formata, a TikTok ih označava kao neponovljive.
  • video_pull_failed, photo_pull_failed: TikTok nije mogao preuzeti datoteku ili nije to učinio u roku od sata; pokušajte ponovno kad je URL javno dostupan.
  • internal: dio TikTokove usluge bio je nedostupan, a ponovni pokušaj je u redu.
  • spam_risk_too_many_posts, spam_risk, spam_risk_text: TikTok je zaustavio objavu zbog količine, ponašanja ili sadržaja opisa.
  • auth_removed: račun je tijekom obrade povukao pristup aplikacije, a TikTok kaže da se ne pokušava ponovno.
  • spam_risk_user_banned_from_posting: račun je blokiran za nove objave.

Čemu služi ID objave?

Za pronalaženje objave kasnije. TikTokova referenca prosljeđuje ID-jeve objava u /business/video/list/ u filters.video_ids kako bi pročitala metrike objava. Pozivi za komentare, pak, uzimaju item_id objave s popisa videa računa kao video_id, što također prihvaćaju alati za komentare u sustavu easyCoexistence 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 kakav je u tom trenutku, s razlogom kad postoji. Zamolite svog AI asistenta da provjeri ponovno nakon nekoliko minuta, a ne odmah.

Uobičajene pogreške

  • Ponovno objavljivanje jer ništa nije odmah prikazano. Prvi poziv samo je pokrenuo zadatak, pa provjerite njegov status prije nego što objavu ponovno pošaljete.
  • Tretiranje PUBLISH_COMPLETE bez post_ids kao pogreške. ID-jevi mogu kasniti do tri minute, pa provjerite tada.
  • Ponovni pokušaj neuspjeha formata s istom datotekom. file_format_check_failed i ostale provjere traže ispravljenu datoteku.
  • Gašenje URL-a tijekom preuzimanja. TikTok objavu označi s video_pull_failed ili photo_pull_failed kad ne može dohvatiti datoteku.
Radite ovo uz EasyCoexistence

US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Što je share_id kod TikToka?

ID zadatka objavljivanja koji vraćaju endpointi za objavu videa i fotografija. U poziv statusa ulazi kao publish_id.

Postoji li webhook za status objave na TikToku?

Da. Aplikacija pretplaćena s event_type VIDEO preko /business/webhook/update/ prima događaje objavljivanja TikTokovih objava, npr. post.publish.failed s razlogom i publish_id, umjesto ponavljanih provjera statusa.

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

TikTok može trebati do tri minute nakon PUBLISH_COMPLETE da vrati post_ids, a vraća ih samo za javno vidljive objave.

Može li se neuspjela TikTok objava ponovno pokušati?

Ovisi o razlogu. Neuspjesi preuzimanja i interni neuspjesi mogu se ponovno pokušati; neuspjesi formata, trajanja, broja sličica u sekundi i dimenzija slike traže ispravljenu datoteku.

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