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 का Scope ID, वह शीर्ष-स्तरीय अनुमति जो Accounts API के प्रोफ़ाइल, पोस्ट, कमेंट और पब्लिशिंग एंडपॉइंट के ऊपर है।
किसी खाते के प्रोफ़ाइल डेटा में 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, जिसे जून 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, रिटेंशन, traffic sources, दर्शक ब्रेकडाउन और पोस्ट से मिलने वाले क्लिक।
- comment.list: comment.update वेबहुक, जिसे TikTok इन-ऐप कंटेंट के कमेंट और जवाब पढ़ना बताता है।
- video.upload: वीडियो या फ़ोटो पोस्ट को
upload_to_draftयाis_draftके साथ ड्राफ़्ट के रूप में अपलोड करना।
टोकन के स्कोप कैसे देखें?
/tt_user/token_info/get/ से पूछें, जो app_id और ऐक्सेस टोकन लेता है, और टोकन का scope तथा खाते का creator_id लौटाता है। TikTok के उदाहरण स्कोप स्ट्रिंग में video.publish और comment.list.manage भी आते हैं, जिनके नाम पब्लिशिंग और कमेंट-प्रबंधन एंडपॉइंट से मेल खाते हैं, हालाँकि उसके रेफ़रेंस किसी फ़ील्ड को इनमें से किसी से नहीं जोड़ते।
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 account holder authorization यूआरएल पर भेजता है, जो TikTok के पोर्टल में उसके ऐप के लिए बनता है और उन अनुमतियों के नाम पहले से लिखता है, और इसमें केवल अपना एक state मान जोड़ता है। मालिक वही स्वीकार करता है जो TikTok दिखाता है, और TikTok जो scope स्ट्रिंग लौटाता है वह कनेक्शन के साथ सहेजी जाती है। इसके बाद 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 की समीक्षा में दो से तीन कार्य दिवस लग सकते हैं, और 20 मार्च 2026 से TikTok Accounts वाला अनुरोध पहले Accounts API Access Application Form माँगता है। टोकन के लिए मालिक ऐप को फिर से अधिकृत करता है, क्योंकि टोकन के पास वही स्कोप रहते हैं जो जारी होते समय स्वीकृत हुए थे।
अनुमति न हो तो क्या होता है?
किसी कॉल के लिए TikTok का रिटर्न कोड 40001 है, यानी संबंधित ऑपरेशन की अनुमति नहीं, और उसका समाधान permission scope रेफ़रेंस की ओर इशारा करता है। किसी फ़ील्ड के लिए रेफ़रेंस उसे तभी उपलब्ध कराते हैं जब मालिक उसका स्कोप दे चुका हो, और उनका समाधान है कि मालिक उस स्कोप के साथ ऐप को फिर से अधिकृत करे। पूछने से पहले /tt_user/token_info/get/ से टोकन का scope जाँचें।
आम गड़बड़ियाँ
- कनेक्टेड खातों से उम्मीद करना कि उन्हें अपने आप नई ऐप अनुमति मिल जाएगी। उनके टोकन वही स्कोप रखते हैं जो अधिकृति के समय स्वीकृत हुए थे, जब तक हर मालिक ऐप को फिर से अधिकृत न करे।
- 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 निगरानी
इस तारीख को सत्यापित