TikTok API for Business scopes: ano ang nabubuksan ng bawat permission
Dalawang layer ang access sa TikTok API for Business. Ang developer app ay may hawak na permission sa ilalim ng TikTok Accounts, gaya ng Video Publish at Manage Account Comment, na nagbubukas ng mga endpoint. Ang authorization ng account owner ang nagbibigay ng access token scope, gaya ng user.insights at video.list, na nagtatakda kung aling field ang ibabalik. Ipinapakita ng /tt_user/token_info/get/ ang mga scope na dala ng token.
Hinihingi ng easyCoexistence sa account owner ng TikTok ang mga permission ng app nito sa iisang sign-in, para magawa ng Claude, ChatGPT o sarili ninyong code na mag-publish, mag-asikaso ng comment at magbasa ng insights sa pamamagitan ng mga tool nito, at ibinibigay ng get_social_credentials sa sarili ninyong code ang parehong token para sa iba pang endpoint ng Accounts API.
Scope ID ng TikTok Accounts, ang permission sa unang antas sa itaas ng profile, post, comment at publishing endpoint ng Accounts API.
Scope sa likod ng is_business_account at has_advanced_access sa profile data ng account.
Scope na dapat i-grant at panatilihing aktibo ng owner para makatanggap ang app ng comment.update webhook event.
Scope na kailangan ng token para i-upload ang post bilang draft sa halip na i-publish ito.
Araw ng negosyo ang maaaring abutin ng pagrepaso ng TikTok sa pagbabago ng permission ng developer app.
Ano ang dalawang layer ng TikTok permission?
App permission at token scope. Pinipili ang app permission sa My Apps, sa app, sa Scope of permission, at sinusuri ito ng TikTok; may tatlong antas ang mga ito, at sinasaklaw ng permission sa unang antas ang bawat endpoint sa ibaba nito. Ang token scope naman ang inaprubahan ng account owner noong ina-authorize ang app, ibinabalik bilang scope, isang string na pinaghihiwalay ng kuwit, kasama ng bawat token. Kailangan ng tawag ang app permission para sa endpoint nito, at may ilang response field na kailangan din ng scope sa token.
Aling app permission ang nagbubukas ng bawat endpoint?
Nakalista sa API reference ng TikTok, para sa bawat endpoint ng Accounts API, ang permission sa ilalim ng TikTok Accounts na nagbubukas nito, o wala. Tinatawag naman ng permission scope reference at webhook guide nito ang parehong grupo na Business User, Business Media, Business Comment at Business Content, kaya asahan ang dalawang set ng pangalan:
Aling token scope ang nagbubukas ng aling field?
Sa mga reference ng TikTok para sa /business/get/ at /business/video/list/, nakalista ang kinakailangang permission para sa bawat response field, at may dalawa pang feature na may sariling scope:
- user.info.basic:
display_nameatprofile_image. - user.info.username: username, na kailangan ang user.info.basic hanggang Hunyo 2023.
- user.info.profile:
profile_deep_link,bio_descriptionatis_verified. - user.info.stats:
following_count,followers_count,total_likesatvideos_count. - user.account.type:
is_business_accountathas_advanced_access. - user.insights: ang pang-araw-araw na account metrics at ang follower breakdown ayon sa edad, kasarian, bansa at lungsod.
- video.list: mga post field gaya ng
item_id, caption,share_url, likes, comments, shares, reach atvideo_views. - video.insights: watch time, full-watch rate, retention, traffic sources, viewer breakdown at ang mga click na nadadala ng post.
- comment.list: ang comment.update webhook, na inilalarawan ng TikTok bilang pagbasa sa mga comment at reply ng in-app content.
- video.upload: pag-upload ng video o photo post bilang draft, gamit ang
upload_to_draftois_draft.
Paano makikita ang mga scope sa isang token?
Tanungin ang /tt_user/token_info/get/, na tumatanggap ng app_id at access token at nagbabalik ng scope ng token at creator_id ng account. Kasama rin sa mga halimbawang scope string ng TikTok ang video.publish at comment.list.manage, na tugma sa pangalan ng mga publishing at comment-management endpoint, bagaman walang field na itinali ng mga reference nito sa alinman sa dalawa.
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"
}
}Ano ang hinihingi ng koneksyon ng easyCoexistence sa TikTok?
Ang mga permission na hawak ng developer app nito, lahat ay nakikita sa consent page ng TikTok. Ipinapadala ng easyCoexistence ang account owner sa TikTok account holder authorization URL na ginawa ng portal ng TikTok para sa app nito, na may pangalan na ng mga permission na iyon, at nagdaragdag lang ng sariling state value. Ina-approve ng owner ang ipinapakita ng TikTok, at ang scope string na ibinabalik ng TikTok ay itinatabi kasama ng koneksyon. Ang mga endpoint na tinatawag ng easyCoexistence para sa account:
- /business/get/ para sa profile, pang-araw-araw na metrics at follower breakdown.
- /business/video/list/ para sa mga post at metrics ng mga ito.
- /business/video/publish/, /business/photo/publish/ at /business/publish/status/ para sa publishing.
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ at /business/comment/delete/ para sa mga comment.
- /business/webhook/update/, sa antas ng app, para sa comment webhook.
Paano magdadagdag ng permission sa ibang pagkakataon?
Sa dalawang hakbang, isa kada layer. Para sa app, buksan ang My Apps, ang app, Scope of permission, i-edit ito, maglagay ng dahilan na tugma sa mga bagong scope, at i-submit; maaaring abutin ng dalawa hanggang tatlong araw ng negosyo ang pagrepaso ng TikTok, at mula Marso 20, 2026, kailangan muna ng request na may kasamang TikTok Accounts ang Accounts API Access Application Form. Para sa token, ina-authorize muli ng owner ang app, dahil pinapanatili ng token ang mga scope na inaprubahan noong inisyu ito.
Ano ang nangyayari kapag may nawawalang permission?
Para sa isang tawag, ang error code ng TikTok ay 40001, walang permission na gawin ang kaugnay na operasyon, at ang ayos nito ay tumuturo sa permission scope reference. Para sa field, ginagawa itong available ng mga reference kapag naibigay na ng owner ang scope nito, at ang ayos nila ay ipa-authorize muli ng owner ang app na may scope na iyon. Suriin ang scope ng token gamit ang /tt_user/token_info/get/ bago magtanong.
Mga karaniwang pagkakamali
- Pag-aakalang makakakuha ng bagong app permission ang mga konektadong account nang kusa. Pinapanatili ng mga token nila ang mga scope na inaprubahan noong authorization hanggang ma-authorize muli ng bawat owner ang app.
- Paghingi ng is_business_account nang walang user.account.type. Ginagawang available ng TikTok ang field na iyon at ang has_advanced_access sa mga token na may scope lang na iyon.
- Paghihintay sa comment.update nang walang comment.list. Nagpapadala ang TikTok ng comment event lamang habang may bisa pa ang authorization ng owner na may scope na iyon.
- Paghahanap ng pangalan ng app permission sa token. Ang scope string ay gumagamit ng mga pangalan gaya ng video.list, habang ang mga pangalan gaya ng Get Account Media ay nasa settings ng app.
US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, kasama ang unang 3 araw na free trial.
Mga madalas itanong
Anong scope ang ginagamit ng TikTok API for Business?
Mga token scope gaya ng user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list at video.upload, na ibinibigay ng account owner bilang dagdag sa mga permission ng app sa TikTok Accounts.
Anong permission ang kailangan ng comment webhook ng TikTok?
Kailangan ng app ang TikTok Accounts at Business Comment, at dapat i-grant ng owner ang comment.list. Humihinto ang mga event kapag nag-expire o na-revoke ang authorization na iyon.
Naaapektuhan ba ng bagong TikTok scope ang mga token na nai-issue na?
Hindi. Pinapanatili ng token ang mga scope na inaprubahan noong inisyu ito, kaya ina-authorize muli ng account owner ang app para magdagdag ng bago.
Gaano katagal bago aprubahan ng TikTok ang bagong permission?
Sinabi ng TikTok na maaaring abutin ng dalawa hanggang tatlong araw ng negosyo ang pagrepaso sa pagbabago ng permission, at kailangan ng mga request na nagdaragdag muna ng TikTok Accounts ang Accounts API Access Application Form.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong