TikTok API कनेक्शन क्यों काम करना बंद करता है, और उसे चालू कैसे रखें
TikTok API for Business कनेक्शन तब काम करना बंद करता है जब उसका 24 घंटे वाला एक्सेस टोकन रिन्यू नहीं होता, उसका एक साल वाला रीफ़्रेश टोकन खत्म हो जाता है, मालिक ऐप की एक्सेस हटा देता है, या भेजा गया टोकन गायब या गलत होता है। TikTok टोकन के इन मामलों को 40102, 40103, 40104 और 40105 कोड से बताता है। समय से पहले रिन्यू करना, हर खाते की नियमित जाँच करना, और साल खत्म होने से पहले मालिक से दोबारा अधिकृत करने को कहना कनेक्शन को चालू रखता है।
easyCoexistence हर TikTok कनेक्शन को अपने आप जीवित रखता है: यह 24 घंटे का टोकन समय से पहले रिन्यू करता है, खाते की लगभग हर 6 घंटे पर जाँच करता है, और जब TikTok टोकन अस्वीकार करता है तो चैनल को Reconnect needed चिह्नित करता है और आपको ईमेल भेजता है, Claude, ChatGPT या आपके अपने प्लेटफ़ॉर्म के लिए।
API for Business से TikTok खाता एक्सेस टोकन की अवधि; /tt_user/oauth2/refresh_token/ इसे रिन्यू करता है।
रीफ़्रेश टोकन की अवधि; एक बार खत्म होने पर खाता मालिक को ऐप को फिर से अधिकृत करना होता है।
विफलता का कारण, जब मालिक TikTok द्वारा पोस्ट प्रोसेस होते समय ऐप की एक्सेस हटा देता है; TikTok दोबारा कोशिश न करने को कहता है।
इवेंट जो TikTok किसी खाते के लिए भेजना बंद कर देता है, जब मालिक का अधिकार खत्म हो या रद्द हो जाए।
TikTok for Developers का authorization.removed क्यों चलता है: उपयोगकर्ता डिस्कनेक्ट करे, खाता हटे, उम्र में बदलाव हो, प्रतिबंध लगे, या डेवलपर रद्द करे।
easyCoexistence हर जुड़े TikTok खाते को कितनी बार जाँचता है; यह 24 घंटे का टोकन अपने आप रिन्यू करता है और दोबारा कनेक्ट करने की ज़रूरत हो तो आपको ईमेल भेजता है।
TikTok API कनेक्शन क्यों काम करना बंद करता है?
कुछ ही कारण होते हैं, और उनमें से ज़्यादातर खाते के टोकन या मालिक की सहमति से जुड़े होते हैं। कुछ कारण कनेक्शन को पूरी तरह बंद कर देते हैं, जबकि कुछ उसे आधा चालू छोड़ देते हैं, जिसमें कुछ कॉल अस्वीकार होती हैं और बाकी जवाब देती रहती हैं:
हर कारण कौन-सी गड़बड़ी लौटाता है, और उसका समाधान क्या है?
TikTok का code फ़ील्ड उनमें से ज़्यादातर को नाम देता है, और यह HTTP 200 जवाब के भीतर आता है, न कि गड़बड़ी वाले स्टेटस में। पब्लिशिंग स्टेटस की अपनी विफलता का कारण भी होता है। 40100 तालिका में इसलिए है क्योंकि रेट लिमिट वाली कॉल खोए हुए कनेक्शन जैसी दिख सकती है। हर एक का अर्थ और समाधान:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause the endpoint 5 minutes; the token still works |
टोकन कितने समय तक चलते हैं, और कब रिन्यू करें?
API for Business पर एक्सेस टोकन 24 घंटे चलता है, और हर टोकन जवाब में expires_in बचे हुए सेकंड बताता है; रीफ़्रेश टोकन एक साल चलता है, जिसकी अपनी उलटी गिनती refresh_token_expires_in में होती है। दिन खत्म होने से काफ़ी पहले रिन्यू करें, किसी विफल कॉल के बाद नहीं बल्कि शेड्यूल के अनुसार, और हर रिन्यूअल से मिला रीफ़्रेश टोकन सहेजें, क्योंकि उस फ़ील्ड पर TikTok का नोट कहता है कि उसे रखें। refresh_token_expires_in को समय-सीमा मानें: TikTok के रिन्यूअल उदाहरण में यह नया साल शुरू करने के बजाय उलटी गिनती करता है।
जब मालिक ऐप की एक्सेस हटा दे, तब क्या होता है?
ऐप उन Accounts API अनुमतियों को खो देता है जो मालिक ने दी थीं, इसलिए उस टोकन से की गई कॉल काम करना बंद कर देती हैं, और TikTok API for Business का ऐसा कोई इवेंट दस्तावेज़ित नहीं करता जो यह घोषणा करे। मालिक यह कभी भी TikTok ऐप में कर सकता है: सेटिंग और प्राइवेसी, फिर सिक्योरिटी, फिर Manage app permissions, फिर Remove access। इसके संकेत कहीं और दिखते हैं: TikTok द्वारा प्रोसेस हो रहा पोस्ट auth_removed के साथ विफल होता है, जिसके लिए TikTok दोबारा कोशिश न करने को कहता है, और उस खाते के comment.update इवेंट आने बंद हो जाते हैं।
खाते का प्रकार बदलने से कनेक्शन पर क्या असर होता है?
TikTok अपने दस्तावेज़ों में इसे किसी टोकन त्रुटि से नहीं जोड़ता; बदलता यह है कि API क्या लौटाता है। unique_video_views, daily_new_followers और audience_activity जैसे डेटा के लिए Advanced Access या Verified Business Account चाहिए, Mentions और Business Messaging APIs को भी यही चाहिए, और निजी खाते का privacy_level_options PUBLIC_TO_EVERYONE को छोड़ देता है। 16 अक्टूबर 2026 से is_business_account केवल Verified Business Accounts के लिए true लौटता है और has_advanced_access Advanced Access बताता है, इसलिए user.account.type के अंतर्गत दोनों पढ़ने से बदलाव दिखता है, इससे पहले कि कोई कॉल उससे टकराए।
मरे हुए कनेक्शन का पता ग्राहक से पहले कैसे लगाएँ?
ऐसी जाँचों से जो इस बात से स्वतंत्र चलती हैं कि कोई पोस्ट कर रहा है या नहीं:
- हर खाते पर शेड्यूल के अनुसार एक हल्की कॉल, जैसे fields username के साथ /business/get/, जो टोकन काम करना बंद करते ही टोकन त्रुटि लौटाती है।
- /
tt_user/token_info/get/, जिसके लिए कोई अनुमति नहीं चाहिए और जो टोकन का scope लौटाता है, ताकि पक्का हो कि दी गई अनुमतियाँ अभी भी आपके फ़ीचर की कॉल को कवर करती हैं। - हर जवाब आने पर
refresh_token_expires_inको तारीख में बदलना, और मालिक को हफ़्तों पहले याद दिलाना। - किसी ऐसे खाते पर comment.update में चुप्पी जिस पर आम तौर पर टिप्पणियाँ आती हैं, क्योंकि अधिकार खत्म या रद्द होने पर TikTok ये इवेंट रोक देता है।
- 40102, 40103, 40104 और 40105 की गिनती हर खाते के हिसाब से, ताकि कई खातों के बीच एक विफल खाता अलग दिखे।
TikTok खाते को दोबारा कैसे कनेक्ट करें?
उसी खाते के लिए अधिकृत करने की प्रक्रिया फिर से चलाकर। TikTok खाता धारक authorization URL साझा करें, जिसमें एक state मान हो जो वापसी को खाते से जोड़े, और अगर मालिक को अनुमति वाला पेज फिर देखना चाहिए तो disable_auto_auth=1। नया auth_code उसकी 10 मिनट की सीमा के भीतर /tt_user/oauth2/token/ पर बदलें, फिर दोनों सहेजे गए टोकन बदलें। open_id TikTok का उस खाते का एप्लिकेशन-विशिष्ट ID है, इसलिए नए टोकन को सहेजे रिकॉर्ड से उसी से मिलाएँ, दूसरा रिकॉर्ड न बनाएँ।
क्या Content Posting API के कनेक्शन भी इसी तरह खत्म होते हैं?
नहीं। TikTok for Developers, जो Content Posting और Display APIs देता है, ने 2 नवंबर 2026 को अपने टोकन पेज अपडेट किए: उपयोगकर्ता एक्सेस टोकन 2 घंटे के भीतर खत्म होते हैं और रीफ़्रेश टोकन पहली जारी तारीख से 180 दिन चलते हैं। उसके रीफ़्रेश टोकन हर बार बदलते हैं, यानी हर सफल रीफ़्रेश एक नया टोकन लौटाता है और भेजे गए पुराने को तुरंत अमान्य कर देता है। अगर सर्वर बदला हुआ टोकन इस्तेमाल करता रहे, तो बाद के रीफ़्रेश विफल होते हैं और उपयोगकर्ता को फिर से अधिकृत करना पड़ता है। खराब रीफ़्रेश टोकन invalid_grant से विफल होता है, खराब एक्सेस टोकन access_token_invalid और HTTP 401 से, और इसका authorization.removed वेबहुक बताता है कि उपयोगकर्ता क्यों चला गया।
easyCoexistence TikTok कनेक्शन को जीवित रखने के लिए क्या करता है?
यह अपने आप रिन्यू और जाँच करता है, और बताता है कि कब केवल मालिक ही उसे ठीक कर सकता है:
- रिन्यूअल: कॉल से पहले जब 15 मिनट से कम बचे हों, और जाँच के दौरान जब 8 घंटे से कम बचे हों, और हर बार नया रीफ़्रेश टोकन व उसकी समाप्ति सहेजी जाती है।
- हर खाते के लिए एक समय में एक रिन्यूअल, ताकि एक साथ आई कॉल उसे साझा करें।
- जाँच: हर लगभग 6 घंटे पर खाते के username के लिए /business/get/ कॉल।
- टोकन अस्वीकार होने पर, 40102, 40104 या 40105: चैनल पर Reconnect needed दिखता है, मालिक को एक ईमेल मिलता है, और किसी प्लेटफ़ॉर्म को channel.disconnected मिलता है, जिसमें TikTok का मैसेज
disconnected_reasonके रूप में होता है। - तब तक टूल बताते हैं कि खाते को दोबारा कनेक्ट करना होगा, और शेड्यूल्ड पोस्ट reconnect के साथ विफल होती है, TikTok तक पहुँचने के बजाय।
- दोबारा कनेक्ट करना: चैनल के पेज पर Connect TikTok, या नया कनेक्ट सत्र, फिर से लॉग इन करता है और वही
account_idव इवेंट डेस्टिनेशन रखता है।
कैसे कॉन्फ़िगर करें
- Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
- Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
- Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.
आम गड़बड़ियाँ
- शांत comment वेबहुक को शांत खाता मान लेना। अधिकार खत्म होने पर TikTok किसी खाते का comment.update रोक देता है, इसलिए इवेंट का इंतज़ार करने के बजाय खाते की जाँच करें।
- नए रिकॉर्ड में दोबारा कनेक्ट करना। नए टोकन को open_id से मिलाएँ, जो TikTok का उस खाते का एप्लिकेशन-विशिष्ट ID है, और सहेजे रिकॉर्ड को उसी जगह अपडेट करें, उसका इतिहास और सेटिंग रखते हुए।
- 40103 या 40107 को उसी रीफ़्रेश टोकन से दोबारा कोशिश करना। दोनों में से कोई भी दोबारा कोशिश से साफ़ नहीं होता: पहले को नए सिरे से अधिकृत करना होगा, दूसरे को नवीनतम जवाब का रीफ़्रेश टोकन या नया अधिकार चाहिए।
- 40100 को खोया हुआ कनेक्शन मान लेना। यह रेट लिमिट वाली कॉल है; उस एंडपॉइंट को 5 मिनट के लिए रोकें, या दैनिक सीमा के बाद 00:00 UTC तक, और वही टोकन फिर काम करता है।
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन जोड़ने के साथ घटती दर, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
मालिक के बिना TikTok API कनेक्शन हमेशा चल सकता है?
नहीं। रिन्यूअल अधिक से अधिक रीफ़्रेश टोकन के एक साल तक उसे ले जाता है; उसके बाद TikTok का दस्तावेज़ित रास्ता खाते के मालिक द्वारा नया अधिकार है।
कई खातों के TikTok कनेक्शन एक साथ क्यों विफल हुए?
पहले खातों के बजाय ऐप देखें: 40113 का मतलब है कि ऐप ब्लॉक है या उसका ID और secret मेल नहीं खाते, और TikTok दुरुपयोग के लिए ऐप की Accounts API एक्सेस रद्द कर सकता है।
क्या नए फ़ीचर के लिए TikTok खाते दोबारा कनेक्ट करने होंगे?
जब उसे ऐसा स्कोप चाहिए जो मालिक ने कभी नहीं दिया, तब हाँ। टोकन अधिकार के समय मंज़ूर स्कोप रखता है, इसलिए नया स्कोप जोड़ने के लिए मालिक ऐप को फिर से अधिकृत करता है।
जब खाते को दोबारा कनेक्ट करना हो, तब TikTok की शेड्यूल्ड पोस्ट का क्या होता है?
easyCoexistence पर वे अपने समय पर reconnect के साथ विफल होती हैं, TikTok तक नहीं पहुँचतीं, मालिक को ईमेल जाता है, और खाता फिर जुड़ने के बाद Retry उन्हें भेज देता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित