TikTok API for Business का स्कोपहरू: प्रत्येक अनुमतिले के खोल्छ
TikTok API for Business ले दुई तहमा पहुँच दिन्छ। विकासकर्ताको एपले TikTok Accounts अन्तर्गत अनुमति राख्छ, जस्तै Video Publish र Manage Account Comment, जसले एन्डपोइन्ट खोल्छ। खाता धनीको स्वीकृतिले टोकनमा user.insights र video.list जस्ता स्कोप दिन्छ, जसले कुन फिल्ड फर्किन्छ भन्ने तय गर्छ। /tt_user/token_info/get/ ले टोकनमा भएका स्कोप देखाउँछ।
easyCoexistence ले TikTok खाताधनीबाट एउटै साइन इनमा एपसँग भएका सबै अनुमति माग्छ, ताकि Claude, ChatGPT वा तपाईंको आफ्नै कोडले यसका उपकरणमार्फत पोस्ट प्रकाशित गर्न, टिप्पणीमा काम गर्न र इनसाइट पढ्न सकून्, र get_social_credentials ले तपाईंको आफ्नै कोडलाई अन्य Accounts API एन्डपोइन्टका लागि उही टोकन दिन्छ।
TikTok Accounts को स्कोप ID, जुन एपीआई को प्रोफाइल, पोस्ट, टिप्पणी र प्रकाशन एन्डपोइन्ट भन्दा माथिको पहिलो तहको अनुमति हो।
खाताको प्रोफाइल डेटामा is_business_account र has_advanced_access पछाडिको स्कोप हो।
खाताधनीले दिएर सक्रिय राख्नुपर्ने स्कोप, जसले एपलाई comment.update वेबहुक इभेन्ट पाउन दिन्छ।
पोस्ट प्रकाशित गर्नुको सट्टा ड्राफ्टको रूपमा अपलोड गर्न टोकनलाई चाहिने स्कोप।
TikTok ले एपको अनुमति परिवर्तनको समीक्षा गर्न लिन सक्ने कार्यदिन।
TikTok अनुमतिका दुई तहहरू के हुन्?
एपका अनुमति र टोकनका स्कोप। एपका अनुमति My Apps मा, एपमा, Scope of permission अन्तर्गत छानिन्छन्, र TikTok ले तिनको समीक्षा गर्छ। तिनका तीन तह छन्, र पहिलो तहको अनुमतिले तलका हरेक एन्डपोइन्ट समेट्छ। टोकनका स्कोप भनेका खाताधनीले एप अधिकृत गर्दा स्वीकृत गरेका कुराहरू हुन्, जुन प्रत्येक टोकनसँग अल्पविरामले छुट्याइएको एउटा स्ट्रिङ scope को रूपमा फर्किन्छ। कुनै अनुरोधलाई एन्डपोइन्टका लागि एपको अनुमति चाहिन्छ, र कुनै प्रतिक्रिया फिल्डलाई टोकनमा स्कोप पनि चाहिन्छ।
कुन एपको अनुमतिले हरेक एन्डपोइन्ट खोल्छ?
TikTok को API सन्दर्भले हरेक Accounts API एन्डपोइन्टका लागि TikTok Accounts अन्तर्गतको त्यो अनुमति सूचीबद्ध गर्छ जसले त्यो खोल्छ, वा कुनै पनि होइन। यसको permission scope सन्दर्भ र वेबहुक गाइडले उही समूहलाई Business User, Business Media, Business Comment र Business Content भनेर बोलाउँछ, त्यसैले दुवै सेटका नामको अपेक्षा गर्नुहोस्:
कुन टोकन स्कोपले कुन फिल्ड खोल्छ?
/business/get/ र /business/video/list/ का TikTok सन्दर्भहरूले प्रत्येक प्रतिक्रिया फिल्डका लागि आवश्यक अनुमति दिन्छन्, र अन्य दुई सुविधाले आफ्नै स्कोप नाम दिन्छन्:
- user.info.basic:
display_nameरprofile_imageखुल्छन्। - user.info.username: username, जसलाई June 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: दैनिक खाता मेट्रिक्स र उमेर, लिङ्ग, देश र शहर अनुसार फलोअरको विवरण।
- video.list:
item_id, caption,share_url, likes, comments, shares, reach रvideo_viewsजस्ता पोस्टका फिल्ड। - video.insights: watch time, full-watch rate, retention, ट्राफिक स्रोत, दर्शक विवरण र पोस्टले ल्याउने क्लिकहरू।
- comment.list: comment.update वेबहुक, जसलाई TikTok ले एप भित्रको सामग्रीका टिप्पणी र उत्तर पढ्ने भनी वर्णन गर्छ।
- video.upload:
upload_to_draftवाis_draftसहित भिडियो वा फोटो पोस्ट ड्राफ्टको रूपमा अपलोड गर्ने।
टोकनमा भएका स्कोप कसरी हेर्ने?
/tt_user/token_info/get/ लाई app_id र access token दिएर सोध्नुहोस्। यसले टोकनको scope र खाताको creator_id फर्काउँछ। TikTok का उदाहरण स्कोप स्ट्रिङमा video.publish र comment.list.manage पनि पर्छन्, जसका नाम प्रकाशन र टिप्पणी व्यवस्थापन एन्डपोइन्ट सँग मेल खान्छन्, यद्यपि TikTok का सन्दर्भहरूले कुनै फिल्डलाई तिनमा जोड्दैनन्।
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 जडानले के माग्छ?
यसले आफ्नो विकासकर्ता एपले राखेका सबै अनुमति माग्छ, जुन TikTok को सहमति पृष्ठमा सबै देखिन्छन्। easyCoexistence ले खाताधनीलाई TikTok को पोर्टलले आफ्नो एपका लागि बनाएको TikTok account holder authorization यूआरएल मा पठाउँछ। त्यस यूआरएल मा ती अनुमति पहिल्यै नाम लिइएका छन्, र यसले आफ्नै state मान मात्र थप्छ। खाताधनीले TikTok ले देखाएको कुरामा स्वीकृति दिन्छ, र TikTok ले फर्काएको स्कोप स्ट्रिङ जडानसँगै भण्डारण गरिन्छ। त्यसपछि easyCoexistence ले खाताका लागि यी एन्डपोइन्ट बोलाउँछ:
- /business/get/ प्रोफाइल, दैनिक मेट्रिक्स र फलोअर विवरणका लागि।
- /business/video/list/ पोस्ट र तिनका मेट्रिक्सका लागि।
- /business/video/publish/, /business/photo/publish/ र /business/publish/status/ प्रकाशनका लागि।
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ र /business/comment/delete/ टिप्पणीका लागि।
- /business/webhook/update/, एप तहमा, टिप्पणी वेबहुकका लागि।
पछि अनुमति कसरी थप्ने?
दुई चरणमा, प्रत्येक तहका लागि एक। एपका लागि My Apps, एप, Scope of permission खोल्नुहोस्, सम्पादन गर्नुहोस्, नयाँ स्कोपसँग मेल खाने कारण दिनुहोस् र पेश गर्नुहोस्। TikTok को समीक्षामा दुई देखि तीन कार्यदिन लाग्न सक्छ, र March 20, 2026 देखि TikTok Accounts समावेश भएको अनुरोधलाई पहिले Accounts API Access Application Form चाहिन्छ। टोकनका लागि खाताधनीले एपलाई फेरि अधिकृत गर्नुपर्छ, किनकि टोकनले जारी गर्दा स्वीकृत स्कोप नै राख्छ।
अनुमति हराएमा के हुन्छ?
अनुरोधका लागि, TikTok को त्रुटि कोड 40001 हो, जसको अर्थ सम्बन्धित कार्य गर्ने अनुमति छैन, र यसको समाधानले अनुमति स्कोप सन्दर्भतर्फ संकेत गर्छ। फिल्डका लागि, सन्दर्भहरूले खाताधनीले त्यसको स्कोप दिएपछि मात्र त्यो उपलब्ध हुने बताउँछन्, र तिनको समाधान भनेको खाताधनीलाई त्यो स्कोपसहित एपलाई फेरि अधिकृत गर्न लगाउनु हो। सोध्नुअघि /tt_user/token_info/get/ मार्फत टोकनको स्कोप जाँच गर्नुहोस्।
सामान्य गल्तीहरू
- जडान भएका खाताहरूले आफैं नयाँ एप अनुमति पाउँछन् भन्ने अपेक्षा गर्नु। तिनका टोकनले हरेक खाताधनीले फेरि अधिकृत नगरेसम्म अधिकृत गर्दा स्वीकृत स्कोप नै राख्छन्।
- user.account.type बिना is_business_account माग्नु। TikTok ले त्यो फिल्ड र has_advanced_access केवल त्यो स्कोप बोकेका टोकनमा मात्र उपलब्ध गराउँछ।
- comment.list बिना comment.update कुर्नु। TikTok ले टिप्पणी इभेन्ट केवल खाताधनीको त्यो स्कोपसहितको अधिकृतता मान्य रहेसम्म मात्र पठाउँछ।
- एपका अनुमतिका नाम टोकनमा खोज्नु। स्कोप स्ट्रिङले video.list जस्ता नाम प्रयोग गर्छ, जबकि Get Account Media जस्ता नाम एपको सेटिङमा हुन्छन्।
US$ 9 देखि US$ 0.75 सम्म प्रति जडान प्रति महिना, जडान थप्दै जाँदा घट्दै, र पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
TikTok API for Business ले कुन स्कोप प्रयोग गर्छ?
user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list र video.upload जस्ता टोकन स्कोप, जुन खाताधनीले TikTok Accounts को एपका अनुमतिमाथि दिन्छ।
TikTok को टिप्पणी वेबहुकलाई कुन अनुमति चाहिन्छ?
एपलाई TikTok Accounts, Business Comment चाहिन्छ, र खाताधनीले comment.list दिनुपर्छ। त्यो अधिकृतता सकिएमा वा रद्द भएमा इभेन्ट रोकिन्छ।
नयाँ TikTok स्कोप पहिले जारी भएका टोकनमा लागू हुन्छ?
हुँदैन। टोकनले जारी गर्दा स्वीकृत स्कोप नै राख्छ, त्यसैले नयाँ थप्न खाताधनीले एपलाई फेरि अधिकृत गर्नुपर्छ।
TikTok ले नयाँ अनुमति स्वीकृत गर्न कति समय लगाउँछ?
TikTok भन्छ, अनुमति परिवर्तनको समीक्षामा दुई देखि तीन कार्यदिन लाग्न सक्छ, र TikTok Accounts थप्ने अनुरोधलाई पहिले Accounts API Access Application Form चाहिन्छ।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको