लॉग इनमोफत ट्रायल सुरू करा
easyCoexistence अधिकृत एपीआय

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 तुमच्या स्क्रिप्ट्सना देते.

24 hours

TikTok खात्याच्या ॲक्सेस टोकनचा कालावधी; प्रत्येक टोकन प्रतिसादात expires_in मध्ये उरलेले सेकंद दिले जातात.

1 year

त्यासोबत मिळालेल्या रिफ्रेश टोकनची वैधता; refresh_token_expires_in मध्ये उरलेले सेकंद दिले जातात.

10 minutes

रीडायरेक्टमधील अधिकृतता कोड किती काळ वैध राहतो; तो फक्त एकदाच एक्सचेंज करता येतो.

open_id

खात्याचा ॲप-विशिष्ट आयडी, जो प्रत्येक टोकनसोबत मिळतो आणि Accounts API कॉलमध्ये business_id म्हणून पाठवला जातो.

Bearer

TikTok ने दिलेला token_type: टोकन धारण करणारी कोणतीही व्यक्ती खात्याच्या स्रोतांपर्यंत पोहोचू शकते.

creator_id

/tt_user/token_info/get/ टोकनच्या स्कोपसोबत परत करत असलेला खाते आयडी, जो Accounts API कॉलमध्ये business_id म्हणून वापरता येतो.

अधिकृतता कोड तुमच्या ॲपपर्यंत कसा पोहोचतो?

TikTok खाते-धारकाची अधिकृतता यूआरएल वापरून, जी TikTok डेव्हलपर ॲपसाठी My Apps, App Detail, Basic Information अंतर्गत तयार करते, एकदा ॲपकडे TikTok Accounts परवानगी आली की. खाते मालक ती उघडतो, परवानग्या तपासतो आणि मंजूर करतो. त्यानंतर TikTok ब्राउझरला ॲपच्या रीडायरेक्ट यूआरएलवर पाठवतो, त्याला auth_code जोडलेला असतो, आणि अधिकृतता यूआरएलमध्ये असलेले state मूल्यही सोबत असते. हा कोड 10 मिनिटांसाठी आणि फक्त एका एक्सचेंजसाठी वैध असतो.

  • रीडायरेक्ट यूआरएल: निरपेक्ष, https:// ने सुरू होणारा, / ने संपणारा, क्वेरी स्ट्रिंग, अँकर किंवा पोर्टशिवाय, आणि 10 ते 512 अक्षरांचा.
  • प्रति ॲप 10 पर्यंत रीडायरेक्ट यूआरएल, एकावेळी एक सक्रिय; एक सक्रिय केल्यावर त्याची स्वतःची अधिकृतता यूआरएल तयार होते.
  • 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 खाते-धारक रीडायरेक्ट यूआरएलच्या बरोबर असणे आवश्यक आहे.

Exchange the authorization code
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 मध्ये दोन्ही टोकन व खात्याचा आयडी असतो:

  • access_token: API कॉलसाठी अल्पकालीन टोकन, जे एक दिवस वैध असते.
  • token_type: Bearer, जे TikTok नुसार टोकन धारण करणारी कोणतीही व्यक्ती वापरू शकते.
  • scope: टोकनला मंजूर परवानग्या, स्वल्पविराम-विभक्त एका स्ट्रिंगमध्ये.
  • expires_in: ॲक्सेस टोकन कालबाह्य होण्यापूर्वी उरलेले सेकंद, TikTok च्या उदाहरणात 86400.
  • refresh_token: ॲक्सेसचे नूतनीकरण करणारा टोकन, एक वर्ष वैध; TikTok ची सूचना आहे की तो जतन करावा.
  • refresh_token_expires_in: रिफ्रेश टोकन कालबाह्य होण्यापूर्वी उरलेले सेकंद.
  • open_id: TikTok खात्याचा ॲप-विशिष्ट आयडी.
A token response (scope shortened)
{
  "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 तासांच्या आधी नूतनीकरण शेड्यूल करा, 40102 त्रुटी येण्याची वाट पाहू नका.

Renew a TikTok account access token in Python
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 निवडतो. अधिकृतता रद्द झाल्यावर TikTok त्या खात्यासाठी ॲपला comment.update इव्हेंट पाठवणे थांबवते.

Revoke a TikTok account access token
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 हा खात्याचा ॲप-विशिष्ट आयडी आहे, जो Accounts API कॉल्स business_id म्हणून घेतात. TikTok चे संदर्भ दस्तऐवज डेव्हलपरांना येथे पाठवतात, जेव्हा एखाद्या फील्डसाठी टोकनकडे नसलेली स्कोप हवी असते.

टोकनमुळे कोणत्या त्रुटी येतात?

TikTok त्या प्रतिसादाच्या code फील्डमध्ये देतो, सहसा HTTP स्थिती 200 अंतर्गत, म्हणून कॉलवर विश्वास ठेवण्यापूर्वी code तपासा. टोकन आणि त्यांच्या एक्सचेंजशी संबंधित परत येणारे कोड:

  • 40102: ॲक्सेस टोकन कालबाह्य झाले आहे; त्याचे नूतनीकरण करा आणि पुन्हा कॉल करा.
  • 40103: रिफ्रेश टोकन कालबाह्य झाले आहे; फक्त मालकाचे नवीन अधिकृतता त्याची जागा घेऊ शकते.
  • 40104: विनंतीमध्ये ॲक्सेस टोकन नव्हते.
  • 40105: ॲक्सेस टोकन अवैध किंवा चुकीचे आहे.
  • 40107: रिफ्रेश टोकन अवैध किंवा चुकीचे आहे, उदाहरणार्थ Marketing API टोकनचे नूतनीकरण करण्यासाठी पाठवलेला, जो कधीच कालबाह्य होत नाही.
  • 40110: अधिकृतता कोड रद्द झाला, आधीच वापरला गेला किंवा कालबाह्य झाला आहे.
  • 40131: दोन टोकन एंडपॉइंट्सवर प्रमाणीकरण त्रुटी, चुकीचा ॲप आयडी किंवा सिक्रेट, कालबाह्य कोड, किंवा अवैध वा कालबाह्य रिफ्रेश टोकनमुळे.

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 जोडा.
EasyCoexistence सोबत हे करताना

प्रति कनेक्शन दरमहा 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/ तोच आयडी creator_id म्हणून परत करतो.

पुढे वाचा

TikTok व्यवसाय API चे स्कोप्स: प्रत्येक परवानगी काय उघडतेTikTok Accounts API साठी परवानग्या, TikTok च्या स्वतःच्या नावांनी: प्रत्येकामुळे काय उघडते, फील्डनिहाय टोकन स्कोप्स आणि टोकन कसे तपासायचे.TikTok त्रुटी 40102: ॲक्सेस टोकन कालबाह्यTikTok त्रुटी 40102 म्हणजे ॲक्सेस टोकन कालबाह्य झाले. एपीआय टोकन एक दिवस चालते; रिफ्रेश टोकनने त्याचे नूतनीकरण कसे करायचे ते पाहा.TikTok त्रुटी 40103: रिफ्रेश टोकन कालबाह्य झालेTikTok त्रुटी 40103: रिफ्रेश टोकन कालबाह्य झाले, त्यामुळे प्रवेश नूतनीकरण होत नाही. उपाय म्हणजे नवीन अधिकृतता.TikTok API for Business आणि Content Posting API यांची तुलनाdevelopers.tiktok.com ऐवजी TikTok API for Business: कमेंट आणि त्यांचे वेबहुक, इनसाइट्स, कोणती खाती जोडली जातात आणि टोकन कसे नूतनीकरण होते.TikTok API for Business चे वेबहुक सेट करणेTikTok API for Business ॲप वेबहुकला कसे सबस्क्राइब करावे: /business/webhook/update/, VIDEO व COMMENT इव्हेंट, कॉलबॅक नियम आणि Tiktok-Signature.एपीआयद्वारे TikTok वर व्हिडिओ कसा पोस्ट करायचाTikTok व्यवसाय एपीआयद्वारे व्हिडिओ पोस्ट करा: पब्लिश एंडपॉइंट, JSON बॉडी, share_id आणि स्टेटस कॉल, curl व Python मध्ये.

तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.

कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.

  • 3 दिवस मोफत
  • कधीही रद्द करा
  • फक्त अधिकृत एपीआय
  • 24/7 देखरेख

पडताळले: