TikTok API for Business அணுகல் டோக்கன்கள்: 24 மணி நேரம், புதுப்பித்தல் மற்றும் ரத்து
TikTok API for Business அணுகல் டோக்கன் 24 மணி நேரம் செல்லுபடியாகும்; அது Access-Token தலைப்பில் அனுப்பப்படுகிறது. ஓர் ஆப், உரிமையாளரின் அங்கீகாரக் குறியீட்டை /tt_user/oauth2/token/ எண்ட்பாயிண்டில் பரிமாறி இதைப் பெறுகிறது; அதனுடன் ஓராண்டு செல்லுபடியாகும் refresh_token-உம் கிடைக்கும், அது /tt_user/oauth2/refresh_token/ வழியாக அணுகலைப் புதுப்பிக்கும். ரத்து செய்ய /tt_user/oauth2/revoke/ பயன்படுத்துங்கள்; வழங்கப்பட்ட அனுமதிகளைப் பட்டியலிட /tt_user/token_info/get/ பயன்படுத்துங்கள்.
easyCoexistence ஒரு TikTok கணக்கு உள்நுழையும்போது குறியீட்டைப் பரிமாறுகிறது, 24 மணி நேர டோக்கன் முடிவதற்கு முன்பே புதுப்பிக்கிறது, சுமார் ஒவ்வொரு 6 மணி நேரத்திற்கும் கணக்கைச் சரிபார்க்கிறது.
TikTok கணக்கு அணுகல் டோக்கனின் ஆயுள்; ஒவ்வொரு டோக்கன் பதிலும் expires_in-இல் மீதமுள்ள வினாடிகளைக் குறிக்கும்.
அதனுடன் வழங்கப்படும் refresh_token-இன் செல்லுபடிக் காலம்; refresh_token_expires_in அதன் மீதமுள்ள வினாடிகளைத் தரும்.
Redirect URL-இல் வரும் அங்கீகாரக் குறியீடு எவ்வளவு நேரம் செல்லுபடியாகும்; அது ஒரு முறை மட்டுமே பரிமாறப்படலாம்.
கணக்கின் ஆப்-குறிப்பிட்ட ID; ஒவ்வொரு டோக்கனுடனும் திரும்பும், Accounts API அழைப்புகளில் business_id ஆக அனுப்பப்படும்.
TikTok திருப்பும் token_type: டோக்கனை வைத்திருக்கும் எவரும் கணக்கின் வளங்களை அணுகலாம்.
/tt_user/token_info/get/ திருப்பும் கணக்கு ID; அனுமதியுடன் சேர்ந்து வரும், Accounts API அழைப்புகளில் business_id ஆகப் பயன்படும்.
அங்கீகாரக் குறியீடு உங்கள் ஆப்பை எவ்வாறு வந்தடைகிறது?
TikTok கணக்கு உரிமையாளர் அங்கீகார URL வழியாக வருகிறது. இந்த URL-ஐ TikTok, ஆப் ஏற்கனவே TikTok Accounts அனுமதியைப் பெற்ற பிறகு, டெவலப்பர் ஆப்பின் My Apps, App Detail, Basic Information பகுதியில் உருவாக்குகிறது. கணக்கு உரிமையாளர் அதைத் திறந்து அனுமதிகளை ஆய்வு செய்து ஒப்புக்கொள்கிறார். பிறகு TikTok உலாவியை ஆப்பின் redirect URL-க்கு அனுப்பும், அதில் auth_code இணைக்கப்பட்டிருக்கும்; அங்கீகார URL கொண்டு சென்ற state மதிப்பும் இருக்கும். அந்தக் குறியீடு 10 நிமிடங்களுக்கு மட்டுமே செல்லுபடியாகும், ஒரு முறை மட்டுமே பரிமாற முடியும்.
- Redirect URL: முழுமையானது, https:// என்று தொடங்கி / இல் முடிய வேண்டும், query string, anchor அல்லது port இல்லாமல், 10 முதல் 512 எழுத்துகள் நீளமுடையது.
- ஓர் ஆப்புக்கு அதிகபட்சம் 10 redirect URL, ஒரு நேரத்தில் ஒன்று மட்டும் செயலில்; ஒன்றைச் செயல்படுத்தினால் அதற்கான அங்கீகார URL உருவாகும்.
- state: விருப்பத் தேர்வு; திருப்பிவிடும் போது TikTok திருப்பியனுப்பும் மதிப்பு, CSRF-க்கு எதிரான பாதுகாப்பாகப் பரிந்துரைக்கப்படுகிறது.
disable_auto_auth=1: முன்பு இதே அனுமதிகளை ஒப்புக்கொண்ட உரிமையாளர்களுக்கு ஆய்வுப் பக்கத்தைக் காட்டும்; இல்லையெனில் அவர்கள் உடனே திருப்பிவிடப்படுவார்கள்.
குறியீட்டை டோக்கன்களுக்கு எவ்வாறு பரிமாறுவது?
உங்கள் சர்வரிலிருந்து 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 கணக்கு உரிமையாளர் 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:access_tokenகாலாவதியாக மீதமுள்ள வினாடிகள்; TikTok எடுத்துக்காட்டில் 86400.refresh_token: அணுகலைப் புதுப்பிக்கும் டோக்கன், ஓராண்டு செல்லுபடியாகும்; அதை வைத்திருக்கச் சொல்கிறது TikTok.refresh_token_expires_in:refresh_tokenகாலாவதியாக மீதமுள்ள வினாடிகள்.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 மணி நேரம் முடிவதற்கு முன்பே புதுப்பிக்குமாறு திட்டமிடுங்கள்; பிழை 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 ஆப்பைத் திறந்து, Settings and privacy, Security, Manage app permissions என்பதற்குச் சென்று, ஆப்பைத் தேர்ந்தெடுத்து Remove access என்பதைத் தேர்வு செய்கிறார். அங்கீகாரம் ரத்து செய்யப்பட்டதும், அந்தக் கணக்குக்கான comment.update நிகழ்வுகளை TikTok ஆப்புக்கு அனுப்புவதை நிறுத்தும்.
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 ஆக எடுக்கும். ஒரு புலத்துக்கு டோக்கனில் இல்லாத scope தேவைப்படும் போதெல்லாம் TikTok-இன் குறிப்புகள் உங்களை இங்கே அனுப்புகின்றன.
டோக்கன்களிலிருந்து வரும் பிழைகள் எவை?
TikTok பிழைகளை பதிலின் code புலத்தில் வைக்கிறது, பொதுவாக HTTP நிலை 200 உடன்; எனவே அழைப்பை நம்புவதற்கு முன் code-ஐச் சரிபாருங்கள். டோக்கன்களுடனும் அவற்றின் பரிமாற்றத்துடனும் தொடர்புடைய திரும்பும் குறியீடுகள்:
- 40102:
access_tokenகாலாவதியானது; அதைப் புதுப்பித்துப் பின் மீண்டும் அழைக்கவும். - 40103:
refresh_tokenகாலாவதியானது; கணக்கு உரிமையாளரின் புதிய அங்கீகாரம் மட்டுமே அதை மாற்றும். - 40104: கோரிக்கையில்
access_tokenஇல்லை. - 40105:
access_tokenசெல்லாதது அல்லது தவறானது. - 40107:
refresh_tokenசெல்லாதது அல்லது தவறானது; உதாரணமாக Marketing API டோக்கனைப் புதுப்பிக்க அனுப்பப்பட்டது, அது ஒருபோதும் காலாவதியாகாது. - 40110: அங்கீகாரக் குறியீடு ரத்து செய்யப்பட்டது, ஏற்கனவே பயன்படுத்தப்பட்டது அல்லது காலாவதியானது.
- 40131: இரண்டு டோக்கன் எண்ட்பாயிண்ட்களிலும் ஏற்பட்ட அங்கீகாரப் பிழை; தவறான ஆப் ID அல்லது secret, காலாவதியான குறியீடு, அல்லது செல்லாத அல்லது காலாவதியான
refresh_tokenஆகியவற்றால்.
easyCoexistence உங்களுக்காக எதைப் புதுப்பிக்கிறது?
உள்நுழைவுக்குப் பின் எல்லாமே. TikTok திருப்பிவிட்டவுடன் easyCoexistence குறியீட்டைப் பரிமாறுகிறது, இரண்டு டோக்கன்களையும் குறியாக்கம் செய்து சேமிக்கிறது, access_token-ஐ அதுவே புதுப்பிக்கிறது: 15 நிமிடங்களுக்கும் குறைவாக மீதமிருக்கும் போது அழைப்புக்கு முன், மேலும் ஒவ்வொரு கணக்கிலும் சுமார் ஒவ்வொரு 6 மணி நேரத்திற்கும் ஓடும் சோதனையில் 8 மணி நேரத்திற்கும் குறைவாக மீதமிருக்கும் போது. ஒவ்வொரு புதுப்பிப்பும் புதிய refresh_token-ஐயும் அதன் காலாவதியையும் சேமிக்கிறது; ஒன்றாக வரும் அழைப்புகள் ஒரே புதுப்பிப்பைப் பகிர்ந்துகொள்கின்றன.
- நிராகரிக்கப்பட்ட டோக்கன்: TikTok 40102, 40104 அல்லது 40105 என்று பதிலளித்தால், இணைப்பு மறுஇணைப்புக்குக் குறிக்கப்படும், உரிமையாளருக்கு மின்னஞ்சல் செல்லும்; Partner API பயனர்களுக்கு channel.disconnected-உம் வரும்.
- உங்கள் சொந்தக் குறியீடு:
get_social_credentials, அல்லது Partner API-இல் GET /channels/{id}?credentials=1, தற்போதைய டோக்கனையும்token_expires_at-ஐயும் தரும்; எனவே ஒவ்வொரு பணிக்கும் அதைப் பெறுங்கள். - நீக்குதல்: டாஷ்போர்டில் இணைப்பை நீக்குதல், அல்லது DELETE /channels/{id}, TikTok-இல் /
tt_user/oauth2/revoke/ வழியாக டோக்கனை ரத்து செய்யும்.
பொதுவான தவறுகள்
- அங்கீகாரக் குறியீட்டை உலாவியில் பரிமாறுவது. பரிமாற்றம் ஆப்பின் client_secret-ஐ அனுப்புகிறது; எனவே திருப்பிவிடலுக்குப் பின் 10 நிமிடங்களுக்குள், உங்கள் சர்வரிலிருந்து செய்யுங்கள்.
- expires_in-ஐ ஒரு தேதியாகப் படிப்பது. அது மீதமுள்ள வினாடிகளைக் கொண்டுள்ளது; டோக்கன் எப்போது காலாவதியாகும் என்று அறிய பதிலின் நேரத்துடன் அதைக் கூட்டுங்கள்.
- refresh_token-உடன் ரத்து செய்வது. /tt_user/oauth2/revoke/ access_token-ஐ எடுக்கும், ஆப்பின் client_id மற்றும் client_secret-உடன் சேர்த்து.
- ஒப்புதல் பக்கம் இல்லாததைத் தோல்வி என்று கருதுவது. உரிமையாளர் முன்பு ஒப்புக்கொண்ட அனுமதிகளுக்கு TikTok ஒப்புதல் பக்கத்தைத் தவிர்க்கிறது; அதை மீண்டும் காட்ட disable_auto_auth=1-ஐச் சேர்த்திடுங்கள்.
அதனால் Claude, ChatGPT அல்லது உங்கள் சொந்தக் குறியீடு TikTok-ஐ தற்போதைய டோக்கனுடன் அழைக்கிறது; get_social_credentials அதை உங்கள் ஸ்கிரிப்டுகளுக்கு வழங்குகிறது. ஓர் இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகளைச் சேர்க்கச் சேர்க்கக் குறையும்; முதல் 7 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
TikTok API for Business அணுகல் டோக்கன் எவ்வளவு நேரம் செல்லுபடியாகும்?
24 மணி நேரம். ஒவ்வொரு டோக்கன் பதிலும் expires_in-இல் மீதமுள்ள வினாடிகளைத் தரும்; ஓராண்டு செல்லுபடியாகும் refresh_token அதைப் புதுப்பிக்கும்.
TikTok புதுப்பிப்பு எண்ட்பாயிண்டுக்கு redirect_uri தேவையா?
அதன் அளவுரு அட்டவணை client_id, client_secret, grant_type மற்றும் refresh_token ஆகியவற்றைப் பட்டியலிடுகிறது, redirect_uri இல்லை; ஆனால் TikTok-இன் அங்கீகார வழிகாட்டி அதன் டோக்கன் எண்ட்பாயிண்ட்களுக்கு redirect_uri தேவை என்கிறது.
TikTok டோக்கனை ரத்து செய்தால் அதன் வெப்ஹூக்குகள் நின்றுவிடுமா?
ஆம். உரிமையாளர் ஆப்பை மீண்டும் அங்கீகரிக்கும் வரை, அந்தக் கணக்குக்கான comment.update நிகழ்வுகளை TikTok ஆப்புக்கு அனுப்பாது.
TikTok business_id எங்கிருந்து வருகிறது?
டோக்கன் பதிலில் உள்ள open_id-இலிருந்து; அதை Accounts API அழைப்புகள் business_id ஆக எடுக்கும். /tt_user/token_info/get/ அதே ID-ஐ creator_id ஆகத் தரும்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: