TikTok API for Business के एक्सेस टोकन: 24 घंटे, रिफ़्रेश और रद्द करना
TikTok API for Business का एक्सेस टोकन 24 घंटे चलता है और Access-Token हेडर में भेजा जाता है। ऐप खाता मालिक का ऑथराइज़ेशन कोड /tt_user/oauth2/token/ पर एक्सचेंज करके इसे पाता है, साथ में एक साल चलने वाला रिफ़्रेश टोकन भी, जो /tt_user/oauth2/refresh_token/ पर एक्सेस का नवीनीकरण करता है। इसे /tt_user/oauth2/revoke/ पर रद्द करें, और इसके दिए गए स्कोप की सूची /tt_user/token_info/get/ पर देखें।
easyCoexistence TikTok खाते के साइन-इन पर कोड एक्सचेंज करता है, 24 घंटे के टोकन के खत्म होने से पहले उसका नवीनीकरण करता है और लगभग हर 6 घंटे में खाते की जांच करता है, ताकि Claude, ChatGPT या आपका अपना कोड TikTok को मौजूदा टोकन के साथ कॉल करे, जिसे get_social_credentials आपकी स्क्रिप्ट्स को देता है।
TikTok खाते के एक्सेस टोकन की अवधि; हर टोकन जवाब में expires_in में बचे सेकंड लिखे होते हैं।
इसके साथ जारी रिफ़्रेश टोकन की वैधता; refresh_token_expires_in उसके बचे सेकंड देता है।
रीडायरेक्ट में आने वाला ऑथराइज़ेशन कोड कितनी देर वैध रहता है; इसे केवल एक बार एक्सचेंज किया जा सकता है।
खाते का ऐप-विशिष्ट ID, जो हर टोकन के साथ लौटता है और Accounts API कॉल में business_id के रूप में भेजा जाता है।
TikTok जो token_type लौटाता है: जिसके पास टोकन हो, वही खाते के संसाधनों तक पहुंच सकता है।
/tt_user/token_info/get/ जो खाता ID स्कोप के साथ लौटाता है, Accounts API कॉल में business_id के रूप में इस्तेमाल हो सकता है।
ऑथराइज़ेशन कोड आपके ऐप तक कैसे पहुंचता है?
TikTok account holder authorization URL के ज़रिए, जिसे TikTok डेवलपर ऐप के लिए My Apps, App Detail, Basic Information में बनाता है, जब ऐप को TikTok Accounts परमिशन मिल जाती है। खाता मालिक इसे खोलता है, परमिशन देखता है और मंज़ूरी देता है। फिर TikTok ब्राउज़र को ऐप के रीडायरेक्ट URL पर भेजता है, जिसके साथ auth_code जुड़ा होता है, और authorization URL में आया कोई state मान भी। यह कोड 10 मिनट तक वैध रहता है और केवल एक बार एक्सचेंज हो सकता है।
- रीडायरेक्ट URL: पूरा, https:// से शुरू, / पर खत्म, बिना क्वेरी स्ट्रिंग, एंकर या पोर्ट, और 10 से 512 अक्षरों लंबा।
- हर ऐप के लिए 10 रीडायरेक्ट URL तक, एक समय पर एक सक्रिय; किसी एक को सक्रिय करने पर उसका अपना authorization URL बनता है।
- state: एक वैकल्पिक मान जिसे TikTok रीडायरेक्ट पर वापस भेजता है; TikTok इसे CSRF से बचाव के लिए सुझाता है।
disable_auto_auth=1: जिन मालिकों ने पहले वही परमिशन मंज़ूर की थीं, उन्हें समीक्षा पेज दिखाता है; वरना TikTok उन्हें तुरंत रीडायरेक्ट कर देता है।
कोड को टोकन में कैसे बदलते हैं?
आपके सर्वर से /tt_user/oauth2/token/ पर JSON के रूप में POST करके। client_id और client_secret वे App ID और Secret हैं जो My Apps, App Detail, Basic Information में दिखते हैं; grant_type authorization_code होता है; auth_code रीडायरेक्ट से मिला कोड है; और redirect_uri को ऐप में सेट किए गए TikTok account holder redirect URL के बराबर होना चाहिए।
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<APP_SECRET>",
"grant_type": "authorization_code",
"auth_code": "<AUTH_CODE>",
"redirect_uri": "https://app.example.com/tiktok/callback/"
}'टोकन जवाब में क्या होता है?
एक JSON ऑब्जेक्ट जिसमें code, message, request_id और data होते हैं। code 0 का मतलब है कि एक्सचेंज सफल रहा, और data में दोनों टोकन और खाते का ID होता है:
access_token: API कॉल के लिए अल्पकालिक टोकन, जो एक दिन वैध है।token_type: Bearer, जिसे TikTok ऐसा बताता है कि टोकन जिसके पास हो वही इस्तेमाल कर सकता है।- scope: टोकन को मिली परमिशन, कॉमा से अलग एक स्ट्रिंग में।
expires_in: एक्सेस टोकन खत्म होने से पहले बचे सेकंड, TikTok के उदाहरण में 86400।refresh_token: वह टोकन जो एक्सेस का नवीनीकरण करता है, एक साल वैध; TikTok का सुझाव है इसे संभालकर रखें।refresh_token_expires_in: रिफ़्रेश टोकन खत्म होने से पहले बचे सेकंड।open_id: TikTok खाते का ऐप-विशिष्ट ID।
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"access_token": "<ACCESS_TOKEN>",
"token_type": "Bearer",
"scope": "user.info.basic,user.info.stats,user.insights,video.list,video.insights,video.publish,comment.list,comment.list.manage",
"expires_in": 86400,
"refresh_token": "<REFRESH_TOKEN>",
"refresh_token_expires_in": 31536000,
"open_id": "<OPEN_ID>"
}
}API कॉल में टोकन कैसे भेजा जाता है?
Access-Token नाम के रिक्वेस्ट हेडर में, /business/get/ से /business/video/publish/ तक के Accounts API एंडपॉइंट पर, जबकि खाते को business_id में नामित किया जाता है, जिसमें उसी जवाब का open_id रखा जाता है। OAuth एंडपॉइंट उल्टे तरीके से काम करते हैं: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ और /tt_user/oauth2/revoke/ JSON बॉडी में ऐप के client_id और client_secret लेते हैं और कोई Access-Token हेडर नहीं लेते।
एक्सेस टोकन का नवीनीकरण कैसे करें?
/tt_user/oauth2/refresh_token/ पर POST करके, जिसमें client_id, client_secret, grant_type को refresh_token पर सेट, और सहेजा हुआ refresh_token हो। जवाब में पहले एक्सचेंज वाले ही फ़ील्ड होते हैं: नया access_token उसके expires_in के साथ, अगले नवीनीकरण के लिए रखने वाला refresh_token और उसके बचे सेकंड। नवीनीकरण 24 घंटे पूरे होने से पहले शेड्यूल करें, error 40102 आने का इंतज़ार न करें।
import os, time, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
def renew(refresh_token: str) -> dict:
r = requests.post(f"{API}/tt_user/oauth2/refresh_token/", json={
"client_id": os.environ["TIKTOK_APP_ID"],
"client_secret": os.environ["TIKTOK_APP_SECRET"],
"grant_type": "refresh_token",
"refresh_token": refresh_token,
}, timeout=30).json()
if r["code"] != 0: # 40103: the refresh token expired, so the owner authorizes again
raise RuntimeError(f"{r['code']}: {r['message']}")
d, now = r["data"], time.time()
return {
"access_token": d["access_token"],
"access_expires_at": now + d["expires_in"],
"refresh_token": d["refresh_token"], # keep it for the next renewal
"refresh_expires_at": now + d["refresh_token_expires_in"],
}एक्सेस कैसे रद्द करें?
ऐप से, /tt_user/oauth2/revoke/ पर POST करके, जिसमें client_id, client_secret और रद्द होने वाला access_token हो; सफलता पर code 0 और खाली data ऑब्जेक्ट लौटता है। खाते की ओर से, मालिक TikTok ऐप खोलता है, सेटिंग और प्राइवेसी, सिक्योरिटी, Manage app permissions पर जाता है, ऐप चुनता है और Remove access चुनता है। एक बार authorization रद्द होने पर TikTok उस खाते के लिए ऐप को comment.update इवेंट भेजना बंद कर देता है।
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/revoke/' \
-H 'Content-Type: application/json' \
-d '{"client_id": "<APP_ID>", "client_secret": "<APP_SECRET>", "access_token": "<ACCESS_TOKEN>"}'
# {"code": 0, "message": "OK", "request_id": "<REQUEST_ID>", "data": {}}टोकन की जांच कैसे करें?
/tt_user/token_info/get/ पर POST करके, जिसके लिए अपनी कोई परमिशन नहीं चाहिए: app_id और access_token भेजें, और data में app_id, scope और creator_id मिलते हैं। scope बताता है कि मालिक ने क्या दिया, और creator_id खाते का ऐप-विशिष्ट ID है, वही मान जिसे Accounts API कॉल business_id के रूप में लेते हैं। TikTok के रेफ़रेंस डेवलपर को यहीं भेजते हैं, जब कोई फ़ील्ड ऐसा स्कोप मांगता है जो टोकन में न हो।
टोकन से कौन सी गड़बड़ियां आती हैं?
TikTok इन्हें जवाब के code फ़ील्ड में रखता है, आम तौर पर HTTP status 200 के साथ, इसलिए कॉल पर भरोसा करने से पहले code जांचें। टोकन और उनके एक्सचेंज से जुड़े रिटर्न कोड:
- 40102: एक्सेस टोकन की अवधि खत्म; उसका नवीनीकरण करें और फिर कॉल दोहराएं।
- 40103: रिफ़्रेश टोकन की अवधि खत्म; उसे केवल मालिक की नई authorization बदल सकती है।
- 40104: रिक्वेस्ट में कोई एक्सेस टोकन नहीं था।
- 40105: एक्सेस टोकन अमान्य या गलत है।
- 40107: रिफ़्रेश टोकन अमान्य या गलत है, जैसे Marketing API टोकन के नवीनीकरण के लिए भेजा गया टोकन, जो कभी खत्म नहीं होता।
- 40110: ऑथराइज़ेशन कोड रद्द हो गया, पहले ही इस्तेमाल हो चुका है या खत्म हो गया है।
- 40131: दोनों टोकन एंडपॉइंट पर प्रमाणीकरण त्रुटि; गलत ऐप ID या secret, खत्म हो चुका कोड, या अमान्य या खत्म रिफ़्रेश टोकन से।
easyCoexistence आपके लिए क्या नवीनीकरण करता है?
साइन-इन के बाद का सब कुछ। easyCoexistence TikTok के रीडायरेक्ट करते ही कोड एक्सचेंज करता है, दोनों टोकन एन्क्रिप्टेड रूप में सहेजता है, और एक्सेस टोकन का खुद नवीनीकरण करता है: कॉल से पहले जब 15 मिनट से कम बचे हों, और हर खाते पर लगभग हर 6 घंटे चलने वाली जांच में जब 8 घंटे से कम बचे हों। हर नवीनीकरण नया रिफ़्रेश टोकन और उसकी समाप्ति सहेजता है, और एक साथ आने वाली कॉल एक ही नवीनीकरण साझा करती हैं।
- अस्वीकृत टोकन: जब TikTok 40102, 40104 या 40105 लौटाता है, तो कनेक्शन दोबारा कनेक्ट करने के लिए चिह्नित होता है और मालिक को ईमेल मिलता है; Partner API उपयोगकर्ताओं को channel.disconnected भी मिलता है।
- आपका अपना कोड:
get_social_credentials, या Partner API पर GET /channels/{id}?credentials=1,token_expires_atके साथ मौजूदा टोकन लौटाता है, इसलिए हर जॉब में उसे अलग से लाएं। - हटाना: डैशबोर्ड में कनेक्शन हटाने पर, या DELETE /channels/{id} से, टोकन /
tt_user/oauth2/revoke/ के ज़रिए TikTok पर रद्द हो जाता है।
आम गड़बड़ियाँ
- ब्राउज़र में ऑथराइज़ेशन कोड एक्सचेंज करना। एक्सचेंज में ऐप का client_secret जाता है, इसलिए इसे रीडायरेक्ट के 10 मिनट के भीतर अपने सर्वर से करें।
- expires_in को तारीख समझना। इसमें बचे सेकंड होते हैं, इसलिए समाप्ति का समय जानने के लिए इसे जवाब के समय में जोड़ें।
- रिफ़्रेश टोकन से रद्द करना। /tt_user/oauth2/revoke/ access_token लेता है, साथ में ऐप का client_id और client_secret।
- सहमति स्क्रीन न दिखने को विफलता समझना। जिन परमिशन को मालिक पहले मंज़ूर कर चुका है, उनके लिए TikTok समीक्षा पेज छोड़ देता है; उसे दोबारा दिखाने के लिए disable_auto_auth=1 जोड़ें।
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे कनेक्शन जुड़ते हैं घटता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
TikTok API for Business का एक्सेस टोकन कितनी देर चलता है?
24 घंटे। हर टोकन जवाब expires_in में बचे सेकंड देता है, और एक साल वैध रिफ़्रेश टोकन उसका नवीनीकरण करता है।
क्या TikTok रिफ़्रेश एंडपॉइंट को redirect_uri चाहिए?
उसकी पैरामीटर तालिका में client_id, client_secret, grant_type और refresh_token हैं, redirect_uri नहीं, हालांकि TikTok की authentication गाइड कहती है कि उसके टोकन एंडपॉइंट को redirect_uri चाहिए।
क्या TikTok टोकन रद्द करने से उसके वेबहुक बंद होते हैं?
हां। मालिक ऐप को दोबारा authorize करने तक TikTok उस खाते के लिए ऐप को comment.update इवेंट भेजना बंद रखता है।
TikTok business_id कहां से आता है?
टोकन जवाब के open_id से, जिसे Accounts API कॉल business_id के रूप में लेते हैं। /tt_user/token_info/get/ वही ID creator_id के रूप में लौटाता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित