TikTok API for Business scopeovi: što svako dopuštenje otključava
TikTokov API for Business dodjeljuje pristup u dva sloja. Razvojna aplikacija drži dopuštenja pod TikTok Accounts, poput Video Publish i Manage Account Comment, koja otvaraju endpointe. Autorizacija vlasnika računa daje pristupnom tokenu scopeove, poput user.insights i video.list, koji određuju vraćena polja. /tt_user/token_info/get/ popisuje scopeove koje token nosi.
easyCoexistence traži od vlasnika TikTok računa dopuštenja koja drži njegova aplikacija u jednoj prijavi, pa Claude, ChatGPT ili vlastiti kôd mogu objavljivati, raditi s komentarima i čitati uvide putem njegovih alata, a get_social_credentials daje vlastitom kodu isti token za ostale endpointe Accounts API-ja.
ID scopea TikTok Accounts, dopuštenje prve razine iznad endpointa Accounts API-ja za profil, objave, komentare i objavljivanje.
Scope iza polja is_business_account i has_advanced_access u podacima profila računa.
Scope koji vlasnik mora odobriti i održavati aktivnim da aplikacija prima webhook događaje comment.update.
Scope koji token treba za učitavanje objave kao nacrta umjesto njezinog objavljivanja.
Radnih dana koliko TikTokov pregled promjene dopuštenja razvojne aplikacije može trajati.
Koja su dva sloja TikTok dopuštenja?
Dopuštenja aplikacije i scopeovi tokena. Dopuštenja aplikacije biraju se u My Apps, u aplikaciji, pod Scope of permission, a TikTok ih pregledava; dolaze u tri razine, a dopuštenje prve razine obuhvaća sve endpointe ispod njega. Scopeovi tokena su ono što je vlasnik računa odobrio pri autorizaciji aplikacije, vraćaju se kao scope, kao jedan niz odvojen zarezima, uz svaki token. Poziv treba dopuštenje aplikacije za svoj endpoint, a neka polja odgovora trebaju i scope na tokenu.
Koje dopuštenje aplikacije otvara svaki endpoint?
TikTokova referenca API-ja navodi za svaki endpoint Accounts API-ja dopuštenje pod TikTok Accounts koje ga otvara ili nijedno. Njezina referenca za scope dopuštenja i vodič za webhook nazivaju iste skupine Business User, Business Media, Business Comment i Business Content, pa očekujte oba skupa naziva:
Koji scopeovi tokena otključavaju koja polja?
TikTokove reference za /business/get/ i /business/video/list/ navode potrebno dopuštenje za svako polje odgovora, a dvije druge značajke imaju vlastiti scope:
- user.info.basic:
display_nameiprofile_image. - user.info.username: username, koje je do lipnja 2023. zahtijevalo user.info.basic.
- user.info.profile:
profile_deep_link,bio_descriptioniis_verified. - user.info.stats:
following_count,followers_count,total_likesivideos_count. - user.account.type:
is_business_accountihas_advanced_access. - user.insights: dnevne metrike računa i raščlambe pratitelja po dobi, spolu, zemlji i gradu.
- video.list: polja objava poput
item_id, caption,share_url, likes, comments, shares, reach ivideo_views. - video.insights: vrijeme gledanja, stopa potpunog gledanja, zadržavanje, izvori prometa, raščlambe gledatelja i klikovi koje objava potiče.
- comment.list: webhook comment.update, koji TikTok opisuje kao čitanje komentara i odgovora na sadržaj u aplikaciji.
- video.upload: učitavanje objave videa ili fotografije kao nacrta, uz
upload_to_draftiliis_draft.
Kako vidjeti scopeove na tokenu?
Pozovite /tt_user/token_info/get/, koji prima app_id i pristupni token te vraća scope tokena i creator_id računa. TikTokovi primjeri nizova scopea uključuju i video.publish i comment.list.manage, čiji se nazivi podudaraju s endpointima za objavljivanje i upravljanje komentarima, iako njihove reference ne vežu nijedno polje ni za jedan od njih.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}Što traži TikTok veza koju uspostavlja easyCoexistence?
Dopuštenja koja drži njegova razvojna aplikacija, sva prikazana na TikTokovoj stranici za suglasnost. easyCoexistence šalje vlasnika računa na TikTok URL za autorizaciju nositelja računa koji generira TikTokov portal za njegovu aplikaciju; taj URL već navodi ta dopuštenja, a easyCoexistence dodaje samo vlastitu vrijednost state. Vlasnik odobrava što TikTok prikaže, a niz scopea koji TikTok vrati pohranjuje se uz vezu. Endpointi koje easyCoexistence zatim poziva za račun:
- /business/get/ za profil, dnevne metrike i raščlambe pratitelja.
- /business/video/list/ za objave i njihove metrike.
- /business/video/publish/, /business/photo/publish/ i /business/publish/status/ za objavljivanje.
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ i /business/comment/delete/ za komentare.
- /business/webhook/update/, na razini aplikacije, za webhook komentara.
Kako naknadno dodati dopuštenje?
U dva koraka, po jedan za svaki sloj. Za aplikaciju otvorite My Apps, aplikaciju, Scope of permission, uredite ga, navedite razlog koji odgovara novim scopeovima i pošaljite zahtjev; TikTokov pregled može trajati dva do tri radna dana, a od 20. ožujka 2026. zahtjev koji uključuje TikTok Accounts prvo treba Accounts API Access Application Form. Za token vlasnik ponovno autorizira aplikaciju, jer token zadržava scopeove odobrene pri izdavanju.
Što se događa kada nedostaje dopuštenje?
Za poziv TikTokov povratni kôd je 40001, nema dopuštenja za povezanu operaciju, a njegovo rješenje upućuje na referencu za scope dopuštenja. Za polje reference ga čine dostupnim tek kad vlasnik odobri njegov scope, a rješenje je da vlasnik ponovno autorizira aplikaciju s tim scopeom. Prije nego što se obratite podršci, provjerite scope tokena pomoću /tt_user/token_info/get/.
Uobičajene pogreške
- Očekivanje da povezani računi sami dobiju novo dopuštenje aplikacije. Njihovi tokeni zadržavaju scopeove odobrene pri autorizaciji, dok svaki vlasnik ponovno ne autorizira aplikaciju.
- Traženje is_business_account bez user.account.type. TikTok to polje i has_advanced_access čini dostupnima samo tokenima koji nose taj scope.
- Čekanje na comment.update bez comment.list. TikTok šalje događaje komentara samo dok autorizacija vlasnika s tim scopeom ostaje valjana.
- Traženje naziva dopuštenja aplikacije u tokenu. Niz scopea koristi nazive poput video.list, dok nazivi poput Get Account Media pripadaju postavkama aplikacije.
US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, uz prva 3 dana besplatno.
Često postavljana pitanja
Koje scopeove koristi TikTok API for Business?
Scopeove tokena poput user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list i video.upload, koje dodjeljuje vlasnik računa uz dopuštenja TikTok Accounts aplikacije.
Koja dopuštenja treba TikTokov webhook za komentare?
Aplikacija treba TikTok Accounts i Business Comment, a vlasnik mora odobriti comment.list. Događaji prestaju ako ta autorizacija istekne ili bude opozvana.
Vrijedi li novi TikTok scope za već izdane tokene?
Ne. Token zadržava scopeove odobrene pri izdavanju, pa vlasnik računa ponovno autorizira aplikaciju kako bi dodao novi.
Koliko TikTok treba za odobrenje novog dopuštenja?
TikTok kaže da pregled promjene dopuštenja može trajati dva do tri radna dana, a zahtjevi koji prvo dodaju TikTok Accounts trebaju Accounts API Access Application Form.
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