Scopes za TikTok API for Business: kila ruhusa inafungua nini
API for Business ya TikTok inatoa ufikiaji kwa tabaka mbili. Programu ya msanidi ina ruhusa chini ya TikTok Accounts, kama Video Publish na Manage Account Comment, ambazo hufungua endpoints. Idhini ya mmiliki wa akaunti hutoa scopes za access token, kama user.insights na video.list, ambazo huamua sehemu zinazorudishwa. /tt_user/token_info/get/ huorodhesha scopes ambazo token inabeba.
easyCoexistence humwomba mmiliki wa akaunti ya TikTok ruhusa ambazo programu yake inashikilia katika kuingia mara moja, ili Claude, ChatGPT au msimbo wako uweze kuchapisha, kushughulikia maoni na kusoma takwimu kupitia zana zake, na get_social_credentials humpa msimbo wako token ile ile kwa endpoints nyingine za Accounts API.
Scope ID ya TikTok Accounts, ruhusa ya ngazi ya kwanza iliyo juu ya endpoints za profile, post, comment na publishing za Accounts API.
Scope inayotoa is_business_account na has_advanced_access katika data ya wasifu wa akaunti.
Scope ambayo mmiliki lazima aidhinishe na abaki hai, ili programu ipokee matukio ya webhook ya comment.update.
Scope ambayo token inahitaji ili kupakia chapisho kama rasimu badala ya kuchapisha moja kwa moja.
Siku za kazi ambazo ukaguzi wa TikTok wa mabadiliko ya ruhusa za programu ya msanidi unaweza kuchukua.
Tabaka mbili za ruhusa za TikTok ni zipi?
Ruhusa za programu na scopes za token. Ruhusa za programu huchaguliwa chini ya My Apps, programu husika, Scope of permission, na TikTok huzikagua; zinakuja katika ngazi tatu, na ruhusa ya ngazi ya kwanza hufunika kila endpoint iliyo chini yake. Scopes za token ni kile ambacho mmiliki wa akaunti aliidhinisha alipoidhinisha programu, zinarudishwa kama scope, mfuatano mmoja wenye koma, pamoja na kila token. Wito unahitaji ruhusa ya programu kwa endpoint yake, na baadhi ya sehemu za jibu pia zinahitaji scope kwenye token.
Ruhusa gani ya programu hufungua kila endpoint?
Rejea ya API ya TikTok inaorodhesha, kwa kila endpoint ya Accounts API, ruhusa chini ya TikTok Accounts inayoifungua, au hakuna. Rejea yake ya scope za ruhusa na mwongozo wa webhook huyaita makundi hayo hayo Business User, Business Media, Business Comment na Business Content, kwa hiyo tarajia majina yote mawili:
Scopes za token zinafungua sehemu zipi?
Rejea za TikTok za /business/get/ na /business/video/list/ zinatoa ruhusa inayohitajika kwa kila sehemu ya jibu, na vipengele viwili vingine vinataja scope yake yenyewe:
- user.info.basic:
display_namenaprofile_image. - user.info.username: username, ambayo ilihitaji user.info.basic hadi Juni 2023.
- user.info.profile:
profile_deep_link,bio_descriptionnais_verified. - user.info.stats:
following_count,followers_count,total_likesnavideos_count. - user.account.type:
is_business_accountnahas_advanced_access. - user.insights: metriki za kila siku za akaunti na mgawanyo wa wafuasi kwa umri, jinsia, nchi na jiji.
- video.list: sehemu za chapisho kama
item_id, caption,share_url, likes, comments, shares, reach navideo_views. - video.insights: muda wa kutazama, kiwango cha kutazama mzima, retention, vyanzo vya trafiki, mgawanyo wa watazamaji na mibofyo inayoletwa na chapisho.
- comment.list: webhook ya comment.update, ambayo TikTok inaieleza kama kusoma maoni na majibu ya maudhui ya ndani ya programu.
- video.upload: kupakia chapisho la video au picha kama rasimu, kwa
upload_to_draftauis_draft.
Unaonaje scopes kwenye token?
Tuma ombi kwa /tt_user/token_info/get/, linalochukua app_id na access token na kurudisha scope ya token na creator_id ya akaunti. Mifano ya TikTok ya mifuatano ya scope pia inajumuisha video.publish na comment.list.manage, ambayo majina yake yanalingana na endpoints za uchapishaji na usimamizi wa maoni, ingawa rejea zake hazihusishi sehemu yoyote na mojawapo yake.
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"
}
}Muunganisho wa TikTok wa easyCoexistence unaomba nini?
Ruhusa ambazo programu yake ya msanidi inashikilia, zote zikionyeshwa kwenye ukurasa wa idhini wa TikTok. easyCoexistence humpeleka mmiliki wa akaunti kwenye URL ya idhini ya mwenye akaunti ya TikTok, ambayo lango la TikTok huizalisha kwa programu yake na ambayo tayari inataja ruhusa hizo, kisha huongeza thamani yake ya state pekee. Mmiliki anaidhinisha kile TikTok inachoonyesha, na mfuatano wa scope ambao TikTok inarudisha unahifadhiwa pamoja na muunganisho. Endpoints ambazo easyCoexistence kisha huita kwa akaunti ni:
- /business/get/ kwa wasifu, metriki za kila siku na mgawanyo wa wafuasi.
- /business/video/list/ kwa machapisho na metriki zake.
- /business/video/publish/, /business/photo/publish/ na /business/publish/status/ kwa uchapishaji.
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ na /business/comment/delete/ kwa maoni.
- /business/webhook/update/, katika ngazi ya programu, kwa webhook ya maoni.
Unaongezaje ruhusa baadaye?
Katika hatua mbili, moja kwa kila ngazi. Kwa programu, fungua My Apps, programu husika, Scope of permission, hariri, toa sababu inayolingana na scope mpya na uwasilishe; ukaguzi wa TikTok unaweza kuchukua siku mbili hadi tatu za kazi, na tangu 20 Machi 2026 ombi linalojumuisha TikTok Accounts linahitaji kwanza Accounts API Access Application Form. Kwa token, mmiliki anaidhinisha programu tena, kwa kuwa token huhifadhi scopes zilizoidhinishwa wakati ilitolewa.
Nini hutokea ruhusa ikikosekana?
Kwa wito, msimbo wa kurudi wa TikTok ni 40001, hakuna ruhusa ya kutekeleza operesheni husika, na suluhisho lake linaelekeza kwenye rejea ya scope ya ruhusa. Kwa sehemu, rejea zinaifanya ipatikane tu mara mmiliki atakapokuwa ametoa scope yake, na suluhisho lao ni mmiliki kuidhinisha programu tena na scope hiyo. Kagua scope ya token kwa /tt_user/token_info/get/ kabla ya kuuliza.
Makosa ya kawaida
- Kutarajia akaunti zilizounganishwa zipate ruhusa mpya ya programu zenyewe. Token zao huhifadhi scopes zilizoidhinishwa wakati wa idhini hadi kila mmiliki aidhinishe programu tena.
- Kuomba is_business_account bila user.account.type. TikTok inafanya sehemu hiyo na has_advanced_access zipatikane tu kwa token zinazobeba scope hiyo.
- Kusubiri comment.update bila comment.list. TikTok hutuma matukio ya maoni tu wakati idhini ya mmiliki yenye scope hiyo bado ni halali.
- Kutafuta majina ya ruhusa ya programu kwenye token. Mfuatano wa scope hutumia majina kama video.list, wakati majina kama Get Account Media yako kwenye mipangilio ya programu.
Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka unavyoongeza muunganisho, na siku 3 za kwanza ni bure.
Maswali yanayoulizwa mara kwa mara
API ya TikTok for Business hutumia scopes gani?
Scopes za token kama user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list na video.upload, zinazotolewa na mmiliki wa akaunti juu ya ruhusa za TikTok Accounts za programu.
Webhook ya maoni ya TikTok inahitaji ruhusa zipi?
Programu inahitaji TikTok Accounts na Business Comment, na mmiliki lazima atoe comment.list. Matukio yanasimama idhini hiyo ikiisha muda wake au ikifutwa.
Je, scope mpya ya TikTok inatumika kwa token zilizotolewa tayari?
Hapana. Token huhifadhi scopes zilizoidhinishwa wakati ilitolewa, kwa hiyo mmiliki wa akaunti lazima aidhinishe programu tena ili kuongeza mpya.
TikTok huchukua muda gani kuidhinisha ruhusa mpya?
TikTok inasema ukaguzi wa mabadiliko ya ruhusa unaweza kuchukua siku mbili hadi tatu za kazi, na maombi yanayoongeza TikTok Accounts kwanza yanahitaji Accounts API Access Application Form.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye