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 ले खाता साइन इन गर्दा कोड आदान-प्रदान गर्छ, 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 हो, जुन विकासकर्ता एपका लागि My Apps, App Detail, Basic Information अन्तर्गत बनिन्छ, एपसँग TikTok Accounts अनुमति भएपछि। खाता मालिकले यो URL खोल्छ, अनुमतिहरू हेर्छ र स्वीकृत गर्छ। त्यसपछि TikTok ले ब्राउजरलाई एपको रिडाइरेक्ट URL मा पठाउँछ, साथमा auth_code र प्राधिकरण URL मा भएको state मान (यदि थियो भने) थपेर। त्यो कोड 10 मिनेटसम्म र एक पटक मात्र मान्य हुन्छ।
- रिडाइरेक्ट URL: https:// बाट सुरु हुने, / मा अन्त्य हुने, query string, एन्कर वा पोर्ट नभएको पूर्ण URL, जसको लम्बाइ 10 देखि 512 अक्षरसम्म हुनुपर्छ।
- प्रति एपमा 10 रिडाइरेक्ट URL सम्म, एकै समयमा एउटा सक्रिय; कुनै एक सक्रिय गर्दा त्यसको आफ्नै प्राधिकरण URL बन्छ।
- state: एउटा वैकल्पिक मान, जुन TikTok ले रिडाइरेक्टमा फिर्ता पठाउँछ; CSRF विरुद्ध सुरक्षाका लागि सुझाइएको।
disable_auto_auth=1: यसले पहिले उही अनुमति स्वीकृत गरेका मालिकहरूलाई समीक्षा पृष्ठ देखाउँछ, जसलाई TikTok अन्यथा तुरुन्तै रिडाइरेक्ट गर्छ।
कोडलाई टोकनमा कसरी आदान-प्रदान गर्नुहुन्छ?
तपाईंको सर्भरबाट JSON सहित /tt_user/oauth2/token/ मा POST अनुरोध पठाएर। client_id र client_secret भनेका My Apps, App Detail, Basic Information मा देखिने App ID र Secret हुन्; 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/"
}'टोकन प्रतिक्रियामा के हुन्छ?
code, message, request_id र data भएको JSON वस्तु। 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/ ले एपको client_id र client_secret JSON बडीमा लिन्छन् र Access-Token हेडर चाहँदैनन्।
एक्सेस टोकन कसरी नवीकरण गर्नुहुन्छ?
client_id, client_secret, grant_type को मान refresh_token, र सुरक्षित गरिएको refresh_token राखेर /tt_user/oauth2/refresh_token/ मा POST गरेर। उत्तरमा पहिलो आदान-प्रदानकै फिल्डहरू हुन्छन्: नयाँ access_token र त्यसको expires_in, अर्को नवीकरणका लागि राख्नुपर्ने refresh_token, र त्यसमा बाँकी सेकेन्ड। 40102 त्रुटि नआउन्जेल नपर्खिनुहोस्; 24 घण्टा अघि नै नवीकरण तालिका बनाउनुहोस्।
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"],
}पहुँच कसरी रद्द गर्नुहुन्छ?
एपबाट, client_id, client_secret र रद्द गर्ने access_token सहित /tt_user/oauth2/revoke/ मा POST गरेर; सफल भए खाली data वस्तुसहित code 0 फर्कन्छ। खाताबाट, मालिकले TikTok एप खोल्छ, Settings and privacy, Security, Manage app permissions मा जान्छ, एप छान्छ र Remove access चुन्छ। अनुमति रद्द भएपछि 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 का सन्दर्भ कागजातहरूले कुनै फिल्डलाई टोकनमा नभएको scope चाहिएमा विकासकर्तालाई यहीँ पठाउँछन्।
टोकनबाट आउने त्रुटिहरू कुन हुन्?
TikTok ले तिनीहरूलाई प्रतिक्रियाको code फिल्डमा राख्छ, सामान्यतः HTTP status 200 अन्तर्गत, त्यसैले कल विश्वास गर्नु अघि code जाँच्नुहोस्। टोकन र यसको आदान-प्रदानसँग जोडिएका रिटर्न कोडहरू:
- 40102: एक्सेस टोकनको म्याद सकियो; नवीकरण गरेर फेरि कल गर्नुहोस्।
- 40103: रिफ्रेस टोकनको म्याद सकियो; मालिकको नयाँ प्राधिकरणले मात्र यसलाई बदल्छ।
- 40104: अनुरोधमा एक्सेस टोकन थिएन।
- 40105: एक्सेस टोकन अमान्य वा गलत छ।
- 40107: रिफ्रेस टोकन अमान्य वा गलत छ, जस्तै Marketing API टोकन नवीकरण गर्न पठाइएको, जुन कहिल्यै म्याद नसकिने टोकन हो।
- 40110: प्राधिकरण कोड रद्द भएको, पहिले नै प्रयोग भएको वा म्याद सकिएको।
- 40131: दुई टोकन एन्डपोइन्टमा प्रमाणीकरण त्रुटि; गलत एप ID वा secret, म्याद सकिएको कोड, वा अमान्य वा म्याद सकिएको रिफ्रेस टोकनबाट।
easyCoexistence ले तपाईंका लागि के नवीकरण गर्छ?
साइन इनपछिको सबै काम। TikTok ले रिडाइरेक्ट गरेको बेला नै easyCoexistence ले कोड आदान-प्रदान गर्छ, दुवै टोकन इन्क्रिप्टेड रूपमा भण्डार गर्छ, र एक्सेस टोकन आफैँ नवीकरण गर्छ: 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 को प्रमाणीकरण गाइडले भन्छ कि यसका टोकन एन्डपोइन्टहरूलाई redirect_uri चाहिन्छ।
के TikTok टोकन रद्द गर्दा त्यसका वेबहुक रोकिन्छ?
हो। मालिकले फेरि अधिकृत नगरेसम्म 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 निगरानी
प्रमाणीकरण गरिएको