TikTok API for Business scopes: එක් එක් අවසරය විවෘත කරන දේ
TikTok හි API for Business ප්රවේශය ස්ථර දෙකකින් ලබා දෙයි. Developer යෙදුම TikTok Accounts යටතේ Video Publish සහ Manage Account Comment වැනි අවසර දරයි, ඒවා endpoint විවෘත කරයි. ගිණුම් හිමියාගේ අනුමතය access token එකට user.insights සහ video.list වැනි scopes ලබා දෙයි, ඒවා ලැබෙන fields තීරණය කරයි. /tt_user/token_info/get/ මගින් token එකක් ගෙන යන scopes ලැයිස්තුගත කරයි.
easyCoexistence TikTok ගිණුම් හිමියාගෙන් ඔවුන්ගේ යෙදුම දරන අවසර එක් sign-in එකකින් ඉල්ලයි, ඉන්පසු Claude, ChatGPT හෝ ඔබේම code එක එහි tools හරහා publish කළ, comments සමඟ වැඩ කළ සහ insights කියවිය හැකිය, සහ get_social_credentials මගින් ඔබේම code එකට අනෙක් Accounts API endpoints සඳහා එකම token එක ලබා දෙයි.
TikTok Accounts හි Scope ID එක, Accounts API හි profile, post, comment සහ publishing endpoints ට ඉහළින් ඇති පළමු මට්ටමේ අවසරයයි.
ගිණුමේ profile දත්තවල is_business_account සහ has_advanced_access පිටුපස ඇති scope එක.
comment.update webhook events ලැබීමට යෙදුමට අවශ්ය scope එක, ගිණුම් හිමියා ලබා දිය යුතු සහ සක්රියව තබා ගත යුතු.
පෝස්ට් එකක් publish කරනවා වෙනුවට draft ලෙස upload කිරීමට token එකට අවශ්ය scope එක.
TikTok විසින් developer යෙදුමේ අවසර වෙනසක් සමාලෝචනය කිරීමට ගතවිය හැකි කාර්ය දින.
TikTok අවසරවල ස්ථර දෙක මොනවාද?
යෙදුමේ අවසර සහ token scopes. යෙදුමේ අවසර My Apps යටතේ, යෙදුම, Scope of permission තුළ තෝරයි, ඒවා TikTok සමාලෝචනය කරයි. ඒවා මට්ටම් තුනකින් පැමිණෙන අතර පළමු මට්ටමේ අවසරයක් ඊට පහළ සියලු endpoint ආවරණය කරයි. Token scopes යනු ගිණුම් හිමියා යෙදුම අනුමත කිරීමේදී දුන් අවසර වන අතර, එක් එක් token එක සමඟ scope යනුවෙන්, කොමා වලින් වෙන් කළ එක් string එකක් ලෙස ලැබේ. Call එකකට endpoint එක සඳහා යෙදුමේ අවසරය අවශ්යයි, සමහර response fields වලට token එකේ scope එකක් ද අවශ්යයි.
කුමන යෙදුම් අවසරයකින් එක් එක් endpoint එක විවෘත වේද?
TikTok API reference එකේ, Accounts API endpoint එක් එක් සඳහා, එය විවෘත කරන TikTok Accounts යටතේ ඇති අවසරය හෝ none ලැයිස්තුගත කර ඇත. එහි permission scope reference සහ webhook guide එකේ එම කණ්ඩායම් Business User, Business Media, Business Comment සහ Business Content ලෙස හඳුන්වයි, එබැවින් නම් දෙවර්ගයම අපේක්ෂා කරන්න.
කුමන token scopes මඟින් කුමන fields විවෘත වේද?
/business/get/ සහ /business/video/list/ සඳහා TikTok හි references, response field එක් එක් සඳහා අවශ්ය අවසරය ලබා දෙන අතර, තවත් විශේෂාංග දෙකක් තමන්ගේම scope එකක් නම් කරයි:
- user.info.basic:
display_nameසහprofile_image. - user.info.username: username, 2023 ජූනි දක්වා user.info.basic අවශ්ය විය.
- user.info.profile:
profile_deep_link,bio_descriptionසහis_verified. - user.info.stats:
following_count,followers_count,total_likesසහvideos_count. - user.account.type:
is_business_accountසහhas_advanced_access. - user.insights: දෛනික ගිණුම් metrics සහ වයස, ලිංගිකත්වය, රට සහ නගරය අනුව follower විභජනයන්.
- video.list:
item_id, caption,share_url, likes, comments, shares, reach සහvideo_viewsවැනි post fields. - video.insights: watch time, full-watch rate, retention, traffic මූලාශ්ර, නරඹන්නන් විභජනයන් සහ post එකක් ඇති කරන clicks.
- comment.list: comment.update webhook, TikTok විසින් in-app content හි comments සහ replies කියවීම ලෙස විස්තර කරයි.
- video.upload: video හෝ photo post එකක්
upload_to_draftහෝis_draftසමඟ draft ලෙස upload කිරීම.
Token එකක scopes බලන්නේ කෙසේද?
/tt_user/token_info/get/ වෙතින් විමසන්න, එය app_id සහ access token එක ගෙන, token එකේ scope සහ ගිණුමේ creator_id ලබා දෙයි. TikTok හි උදාහරණ scope strings වලට video.publish සහ comment.list.manage ද ඇතුළත් වන අතර, ඒවායේ නම් publishing සහ comment-management endpoints වලට ගැලපේ, නමුත් ඒවායේ references කිසිදු field එකක් ඒ දෙකට සම්බන්ධ නොකරයි.
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"
}
}easyCoexistence හි TikTok සම්බන්ධතාවය කුමක් ඉල්ලයි?
එහි developer යෙදුම දරන අවසර, ඒවා සියල්ල TikTok හි අනුමැතිය ලබාදෙන පිටුවේ පෙන්වයි. easyCoexistence ගිණුම් හිමියා TikTok portal එක විසින් යෙදුම සඳහා ජනනය කරන TikTok account holder authorization URL එකට යවයි, එය දැනටමත් එම අවසර නම් කරයි, තමන්ගේ state අගයක් පමණක් එකතු කරයි. ගිණුම් හිමියා TikTok පෙන්වන දේ අනුමත කරයි, TikTok ලබා දෙන scope string එක සම්බන්ධතාවය සමඟ ගබඩා වේ. easyCoexistence පසුව ගිණුම සඳහා කැඳවන endpoints:
- /business/get/ profile, දෛනික metrics සහ follower විභජනයන් සඳහා.
- /business/video/list/ posts සහ ඒවායේ metrics සඳහා.
- /business/video/publish/, /business/photo/publish/ සහ /business/publish/status/ publishing සඳහා.
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ සහ /business/comment/delete/ comments සඳහා.
- /business/webhook/update/, app මට්ටමින්, comment webhook සඳහා.
පසුව අවසරයක් එකතු කරන්නේ කෙසේද?
පියවර දෙකකින්, එක් ස්ථරයකට එකක්. යෙදුම සඳහා, My Apps, යෙදුම, Scope of permission විවෘත කර, සංස්කරණය කර, නව scopes ට ගැලපෙන හේතුවක් දී යොමු කරන්න. TikTok සමාලෝචනයට කාර්ය දින දෙකක් තුනක් ගතවිය හැකි අතර, 2026 මාර්තු 20 සිට TikTok Accounts ඇතුළත් ඉල්ලීමකට පළමුව Accounts API Access Application Form අවශ්යයි. Token එක සඳහා, ගිණුම් හිමියා යෙදුම නැවත අනුමත කරයි, මන්ද token එකක් එය නිකුත් කළ විට අනුමත කළ scopes තබා ගනී.
අවසරයක් නැති වූ විට කුමක් වේද?
Call එකකට, TikTok හි return code එක 40001 වන අතර, එයින් අදාළ ක්රියාව සඳහා අවසරය නැති බව දැක්වේ, එහි විසඳුම permission scope reference වෙත යොමු කරයි. Field එකකට, references අනුව ගිණුම් හිමියා එහි scope එක ලබා දුන් පසු පමණක් එය ලබා ගත හැකි අතර, ඔවුන්ගේ විසඳුම වන්නේ ගිණුම් හිමියා එම scope සමඟ යෙදුම නැවත අනුමත කිරීමයි. ඉල්ලීමට පෙර /tt_user/token_info/get/ සමඟ token එකේ scope පරීක්ෂා කරන්න.
සාමාන්ය වැරදි
- සම්බන්ධිත ගිණුම් තමන්ම නව යෙදුම් අවසරයක් ලබයි කියා අපේක්ෂා කිරීම. ඒවායේ tokens, එක් එක් ගිණුම් හිමියා යෙදුම නැවත අනුමත කරන තුරු, අනුමත කළ scopes තබා ගනී.
- is_business_account ඉල්ලීම user.account.type නැතිව. TikTok එම field සහ has_advanced_access ලබා ගත හැක්කේ එම scope එක ගෙන යන tokens වලට පමණයි.
- comment.list නැතිව comment.update ට බලා සිටීම. ගිණුම් හිමියාගේ එම scope සහිත අනුමතය වලංගු වන තාක් පමණක් TikTok comment events යවයි.
- Token එකේ යෙදුම් අවසර නම් සොයීම. Scope string එක video.list වැනි නම් භාවිත කරන අතර, Get Account Media වැනි නම් යෙදුමේ settings වලට අයත් වේ.
සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ trial කාලය.
නිතර අසන ප්රශ්න
TikTok API for Business භාවිත කරන scopes මොනවාද?
user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list සහ video.upload වැනි token scopes, යෙදුමේ TikTok Accounts අවසර වලට අමතරව ගිණුම් හිමියා ලබා දෙයි.
TikTok comment webhook වලට කුමන අවසර අවශ්යද?
යෙදුමට TikTok Accounts සහ Business Comment අවශ්ය වන අතර, ගිණුම් හිමියා comment.list ලබා දිය යුතුය. එම අනුමතය කල් ඉකුත් වූ හෝ අවලංගු වූ විට events නතර වේ.
නව TikTok scope එකක් දැනටමත් නිකුත් කළ tokens වලට අදාළ වේද?
නැත. Token එකක් එය නිකුත් කළ විට අනුමත කළ scopes තබා ගනී, එබැවින් නව scope එකක් එකතු කිරීමට ගිණුම් හිමියා යෙදුම නැවත අනුමත කරයි.
TikTok නව අවසරයක් අනුමත කිරීමට කොපමණ කාලයක් ගතවේද?
TikTok කියන්නේ අවසර වෙනසක සමාලෝචනයට කාර්ය දින දෙකක් තුනක් ගතවිය හැකි බවයි, සහ TikTok Accounts පළමුව එකතු කරන ඉල්ලීම් වලට Accounts API Access Application Form අවශ්ය වේ.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ