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

TikTok API for Business scopes: šta otključava svaka dozvola

TikTok API for Business daje pristup u dva sloja. Aplikacija developera ima dozvole pod TikTok Accounts, kao što su Video Publish i Manage Account Comment, koje otvaraju endpointe. Autorizacija vlasnika naloga daje access token scope-ove, kao što su user.insights i video.list, koji određuju koja polja se vraćaju. /tt_user/token_info/get/ navodi scope-ove koje token nosi.

easyCoexistence traži od vlasnika TikTok naloga dozvole koje njegova aplikacija ima u jednom prijavljivanju, pa Claude, ChatGPT ili vaš sopstveni kod mogu da objavljuju, rade sa komentarima i čitaju uvide kroz njegove alate.

18000000

Scope ID za TikTok Accounts, dozvola prvog nivoa iznad endpointa Accounts API-ja za profil, objave, komentare i objavljivanje.

user.account.type

Scope iza is_business_account i has_advanced_access u podacima profila naloga.

comment.list

Scope koji vlasnik mora odobriti i održavati aktivnim da bi aplikacija primala webhook događaje comment.update.

video.upload

Scope koji token treba da bi post otpremio kao nacrt umesto da ga objavi.

2 to 3 days

Radni dani koje može da traje TikTokov pregled izmene dozvola developerske aplikacije.

Koja su dva sloja TikTok dozvola?

Dozvole aplikacije i scope-ovi tokena. Dozvole aplikacije biraju se u My Apps, u aplikaciji, pod Scope of permission, a TikTok ih pregleda. Dolaze na tri nivoa, a dozvola prvog nivoa obuhvata svaki endpoint ispod nje. Scope-ovi tokena su ono što je vlasnik naloga odobrio pri autorizaciji aplikacije, vraćaju se kao scope, jedan string odvojen zarezima, uz svaki token. Poziv zahteva dozvolu aplikacije za svoj endpoint, a neka polja odgovora zahtevaju i scope na tokenu.

Koja dozvola aplikacije otvara koji endpoint?

TikTokova API referenca navodi, za svaki endpoint Accounts API-ja, dozvolu pod TikTok Accounts koja ga otvara, ili nijednu. Njegova referenca za scope dozvola i vodič za webhook nazivaju iste grupe Business User, Business Media, Business Comment i Business Content, pa računajte na oba skupa naziva:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

Koji scope-ovi tokena otključavaju koja polja?

TikTokove reference za /business/get/ i /business/video/list/ navode potrebnu dozvolu za svako polje odgovora, a dve druge funkcije imaju sopstveni scope:

  • user.info.basic: display_name i profile_image.
  • user.info.username: username, koje je do juna 2023. zahtevalo user.info.basic.
  • user.info.profile: profile_deep_link, bio_description i is_verified.
  • user.info.stats: following_count, followers_count, total_likes i videos_count.
  • user.account.type: is_business_account i has_advanced_access.
  • user.insights: dnevne metrike naloga i raspodele pratilaca po uzrastu, polu, državi i gradu.
  • video.list: polja objava kao što su item_id, caption, share_url, likes, comments, shares, reach i video_views.
  • video.insights: vreme gledanja, stopa potpunog gledanja, zadržavanje, izvori saobraćaja, raspodele gledalaca i klikovi koje objava pokreće.
  • comment.list: webhook comment.update, koji TikTok opisuje kao čitanje komentara i odgovora na sadržaj unutar aplikacije.
  • video.upload: otpremanje video ili foto objave kao nacrta, uz upload_to_draft ili is_draft.

Kako se vide scope-ovi na tokenu?

Pitajte /tt_user/token_info/get/, koji prima app_id i access token i vraća scope tokena i creator_id naloga. TikTokovi primeri scope stringova uključuju i video.publish i comment.list.manage, čiji nazivi se poklapaju sa endpointima za objavljivanje i upravljanje komentarima, iako njegove reference ne vezuju nijedno polje ni za jedan od njih.

Read the scopes an access token carries
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"
  }
}

Šta traži TikTok veza u easyCoexistence?

Dozvole koje njena developerska aplikacija ima, sve prikazane na TikTokovoj stranici za saglasnost. easyCoexistence šalje vlasnika naloga na TikTok account holder authorization URL koji generiše TikTok portal za njenu aplikaciju. Taj URL već navodi te dozvole, a easyCoexistence dodaje samo sopstvenu vrednost state. Vlasnik odobrava ono što TikTok prikazuje, a scope string koji TikTok vrati čuva se uz vezu. Endpointi koje easyCoexistence zatim poziva za nalog:

  • /business/get/ za profil, dnevne metrike i raspodele pratilaca.
  • /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 nivou aplikacije, za webhook komentara.

Kako se dozvola dodaje kasnije?

U dva koraka, po jedan za svaki sloj. Za aplikaciju otvorite My Apps, aplikaciju, Scope of permission, izmenite ga, navedite razlog koji odgovara novim scope-ovima i pošaljite. TikTokov pregled može da traje dva do tri radna dana, a od 20. marta 2026. godine zahtev koji uključuje TikTok Accounts prvo zahteva Accounts API Access Application Form. Za token, vlasnik ponovo autorizuje aplikaciju, jer token zadržava scope-ove odobrene kada je izdat.

Šta se dešava kad dozvola nedostaje?

Za poziv, TikTokov kod greške je 40001, nema dozvole za povezanu operaciju, a njegovo rešenje upućuje na referencu za scope dozvola. Za polje, reference ga čine dostupnim tek kada vlasnik odobri njegov scope, a njihovo rešenje je da vlasnik ponovo autorizuje aplikaciju sa tim scope-om. Proverite scope tokena pomoću /tt_user/token_info/get/ pre nego što zamolite vlasnika.

Česte greške

  • Očekivati da povezani nalozi sami dobiju novu dozvolu aplikacije. Njihovi tokeni zadržavaju scope-ove odobrene pri autorizaciji, dok svaki vlasnik ponovo ne autorizuje aplikaciju.
  • Tražiti is_business_account bez user.account.type. TikTok to polje i has_advanced_access čini dostupnim samo tokenima koji nose taj scope.
  • Čekati comment.update bez comment.list. TikTok šalje događaje o komentarima samo dok autorizacija vlasnika sa tim scope-om ostaje važeća.
  • Tražiti nazive dozvola aplikacije u scope stringu tokena. Scope string koristi nazive kao što je video.list, a nazivi kao što je Get Account Media pripadaju podešavanjima aplikacije.
Ovo radite uz EasyCoexistence

get_social_credentials daje vašem kodu isti token za ostale endpointe Accounts API-ja. US$ 9 do US$ 0,75 po vezi mesečno, uz smanjenje kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Koje scope-ove koristi TikTok API for Business?

Scope-ove tokena kao što su user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list i video.upload, koje odobrava vlasnik naloga uz TikTok Accounts dozvole aplikacije.

Koje dozvole su potrebne za TikTok 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.

Da li se novi TikTok scope primenjuje na tokene koji su već izdati?

Ne. Token zadržava scope-ove odobrene kada je izdat, pa vlasnik naloga ponovo autorizuje aplikaciju da bi dodao novi.

Koliko TikTok traje odobravanje nove dozvole?

TikTok kaže da njegov pregled izmene dozvole može da traje dva do tri radna dana, a zahtevi koji prvo dodaju TikTok Accounts zahtevaju Accounts API Access Application Form.

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