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

Scope-urile TikTok API for Business: ce deblochează fiecare permisiune

API for Business al TikTok acordă accesul în două straturi. Aplicația de dezvoltator deține permisiuni sub TikTok Accounts, precum Video Publish și Manage Account Comment, care deschid endpoint-uri. Autorizarea titularului contului acordă token-ului scope-uri, precum user.insights și video.list, care decid câmpurile returnate. /tt_user/token_info/get/ listează scope-urile pe care le are un token.

easyCoexistence cere titularului contului TikTok permisiunile aplicației sale dintr-o singură autentificare, astfel încât Claude, ChatGPT sau propriul cod pot publica, lucra cu comentariile și citi insights prin uneltele sale, iar get_social_credentials oferă propriului cod același token pentru alte endpoint-uri ale API-ului Accounts.

18000000

ID-ul scope-ului TikTok Accounts, permisiunea de nivel superior deasupra endpoint-urilor API-ului Accounts pentru profil, postare, comentarii și publicare.

user.account.type

Scope-ul din spatele is_business_account și has_advanced_access din datele profilului unui cont.

comment.list

Scope-ul pe care titularul trebuie să îl acorde și să îl mențină activ, pentru ca aplicația să primească evenimentele webhook comment.update.

video.upload

Scope-ul de care are nevoie un token pentru a încărca o postare ca ciornă, în loc să o publice.

2 to 3 days

Zile lucrătoare în care poate dura revizuirea de către TikTok a unei modificări a permisiunilor aplicației de dezvoltator.

Care sunt cele două straturi ale permisiunilor TikTok?

Permisiunile aplicației și scope-urile token-ului. Permisiunile aplicației se aleg în My Apps, aplicația, Scope of permission, iar TikTok le revizuiește; vin în trei niveluri, iar o permisiune de nivel întâi acoperă fiecare endpoint de mai jos. Scope-urile token-ului sunt ceea ce a aprobat titularul contului la autorizarea aplicației, returnate ca scope, un șir de valori separate prin virgulă, pentru fiecare token. Un apel necesită permisiunea aplicației pentru endpoint-ul său, iar unele câmpuri din răspuns necesită și un scope pe token.

Ce permisiune a aplicației deschide fiecare endpoint?

Referința API-ului TikTok listează, pentru fiecare endpoint al API-ului Accounts, permisiunea din TikTok Accounts care îl deschide sau niciuna. Referința sa privind scope-urile de permisiune și ghidul webhook-urilor numesc aceleași grupuri Business User, Business Media, Business Comment și Business Content, așa că așteptați ambele seturi de nume:

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

Ce scope-uri ale token-ului deblochează ce câmpuri?

Referințele TikTok pentru /business/get/ și /business/video/list/ dau o permisiune necesară pentru fiecare câmp din răspuns, iar alte două funcționalități numesc un scope propriu:

  • user.info.basic: display_name și profile_image.
  • user.info.username: username, care necesita user.info.basic până în iunie 2023.
  • 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: metricile zilnice ale contului și defalcările pe urmăritori după vârstă, gen, țară și oraș.
  • video.list: câmpurile postărilor, precum item_id, caption, share_url, likes, comments, shares, reach și video_views.
  • video.insights: timpul de vizionare, rata de vizionare completă, retenția, sursele de trafic, defalcările pe spectatori și clicurile generate de o postare.
  • comment.list: webhook-ul comment.update, descris de TikTok ca citirea comentariilor și a răspunsurilor la conținutul din aplicație.
  • video.upload: încărcarea unei postări video sau foto ca ciornă, cu upload_to_draft sau is_draft.

Cum vedeți scope-urile unui token?

Întrebați /tt_user/token_info/get/, care primește app_id și token-ul de acces și returnează scope-ul token-ului și creator_id-ul contului. Exemplele de șiruri scope ale TikTok includ și video.publish și comment.list.manage, ale căror nume corespund endpoint-urilor de publicare și de gestionare a comentariilor, deși referințele sale nu leagă niciun câmp de vreunul dintre ele.

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"
  }
}

Ce cere conexiunea TikTok a easyCoexistence?

Permisiunile pe care le deține aplicația sa de dezvoltator, toate afișate pe pagina de consimțământ a TikTok. easyCoexistence îl trimite pe titularul contului către URL-ul de autorizare al titularului contului TikTok, generat de portalul TikTok pentru aplicația sa, care deja numește aceste permisiuni, și adaugă doar o valoare state proprie. Titularul aprobă ceea ce arată TikTok, iar șirul de scope returnat de TikTok este stocat împreună cu conexiunea. Endpoint-urile pe care easyCoexistence le apelează apoi pentru cont:

  • /business/get/ pentru profil, metricile zilnice și defalcările pe urmăritori.
  • /business/video/list/ pentru postări și metricile lor.
  • /business/video/publish/, /business/photo/publish/ și /business/publish/status/ pentru publicare.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ și /business/comment/delete/ pentru comentarii.
  • /business/webhook/update/, la nivel de aplicație, pentru webhook-ul de comentarii.

Cum adăugați ulterior o permisiune?

În doi pași, câte unul pentru fiecare strat. Pentru aplicație, deschideți My Apps, aplicația, Scope of permission, editați-l, dați un motiv care corespunde noilor scope-uri și trimiteți; revizuirea TikTok poate dura două până la trei zile lucrătoare, iar din 20 martie 2026, o cerere care include TikTok Accounts necesită mai întâi Formularul de cerere de acces la API-ul Accounts. Pentru token, titularul contului autorizează din nou aplicația, deoarece un token păstrează scope-urile aprobate la emitere.

Ce se întâmplă când lipsește o permisiune?

Pentru un apel, codul de răspuns al TikTok este 40001, fără permisiune pentru operațiunea respectivă, iar soluția sa trimite la referința privind scope-urile de permisiune. Pentru un câmp, referințele îl fac disponibil doar după ce titularul a acordat scope-ul său, iar soluția lor este ca titularul să autorizeze din nou aplicația cu acel scope. Verificați scope-ul token-ului cu /tt_user/token_info/get/ înainte de a cere.

Greșeli frecvente

  • Așteptarea ca conturile conectate să primească singure o nouă permisiune a aplicației. Token-urile lor păstrează scope-urile aprobate la autorizare, până când fiecare titular autorizează din nou aplicația.
  • Cererea is_business_account fără user.account.type. TikTok face acest câmp și has_advanced_access disponibile doar token-urilor care poartă acel scope.
  • Așteptarea comment.update fără comment.list. TikTok trimite evenimente de comentarii doar cât timp autorizarea titularului cu acel scope rămâne validă.
  • Căutarea în token a numelor permisiunilor aplicației. Șirul de scope folosește nume precum video.list, în timp ce nume precum Get Account Media aparțin setărilor aplicației.
Faceți acest lucru cu EasyCoexistence

De la US$ 9 la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Ce scope-uri folosește TikTok API for Business?

Scope-uri de token precum user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list și video.upload, acordate de titularul contului pe lângă permisiunile TikTok Accounts ale aplicației.

Ce permisiuni are nevoie webhook-ul de comentarii al TikTok?

Aplicația are nevoie de TikTok Accounts, Business Comment, iar titularul trebuie să acorde comment.list. Evenimentele se opresc dacă această autorizare expiră sau este revocată.

Un scope nou al TikTok se aplică token-urilor deja emise?

Nu. Un token păstrează scope-urile aprobate la emitere, așa că titularul contului autorizează din nou aplicația pentru a adăuga unul nou.

Cât durează ca TikTok să aprobe o permisiune nouă?

TikTok spune că revizuirea unei modificări a permisiunilor poate dura două până la trei zile lucrătoare, iar cererile care adaugă mai întâi TikTok Accounts necesită Formularul de cerere de acces la API-ul Accounts.

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