Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

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.

18000000

Scope ID ng TikTok Accounts, ang permission sa unang antas sa itaas ng profile, post, comment at publishing endpoint ng Accounts API.

user.account.type

Scope sa likod ng is_business_account at has_advanced_access sa profile data ng account.

comment.list

Scope na dapat i-grant at panatilihing aktibo ng owner para makatanggap ang app ng comment.update webhook event.

video.upload

Scope na kailangan ng token para i-upload ang post bilang draft sa halip na i-publish ito.

2 to 3 days

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:

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

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_name at profile_image.
  • user.info.username: username, na kailangan ang user.info.basic hanggang Hunyo 2023.
  • user.info.profile: profile_deep_link, bio_description at is_verified.
  • user.info.stats: following_count, followers_count, total_likes at videos_count.
  • user.account.type: is_business_account at has_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 at video_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_draft o is_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.

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

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.
Ginagawa ito gamit ang EasyCoexistence

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