TikTok API for Business access token එක: පැය 24, refresh සහ revoke
TikTok API for Business access token එකක් පැය 24ක් වලංගු වන අතර Access-Token header එකේ ගමන් කරයි. යෙදුමක් එය ලබා ගන්නේ හිමිකරුගේ authorization කේතය /tt_user/oauth2/token/ වෙත හුවමාරු කිරීමෙන්, ඒ සමඟම වසරක් වලංගු refresh token එකක් ලබමින්. එම refresh token එක /tt_user/oauth2/refresh_token/ හරහා access අලුත් කරයි. එය /tt_user/oauth2/revoke/ හි revoke කරයි, සහ /tt_user/token_info/get/ හි ලබා දුන් scope ලැයිස්තුගත කරයි.
easyCoexistence TikTok ගිණුමක් පුරනය වන විට authorization කේතය හුවමාරු කරයි, පැය 24 token එක කල් ඉකුත් වීමට පෙර අලුත් කරයි, සහ ගිණුම සෑම පැය 6කට වරක් පමණ පරීක්ෂා කරයි.
TikTok ගිණුම් access token එකේ ආයු කාලය; සෑම token ප්රතිචාරයකම expires_in හි ඉතිරි තත්පර ප්රකාශ වේ.
ඒ සමඟ නිකුත් වන refresh token එකේ වලංගුභාවය; refresh_token_expires_in මගින් එහි ඉතිරි තත්පර ලැබේ.
redirect එකේ ඇති authorization කේතය කොපමණ කාලයක් වලංගුද; එය එක් වරක් පමණක් හුවමාරු කළ හැක.
ගිණුමේ යෙදුම-විශේෂිත ID එක, සෑම token එකක් සමඟම ලැබී, Accounts API ඇමතුම්වල business_id ලෙස යවයි.
TikTok ලබා දෙන token_type: token එක දරන ඕනෑම අයෙකුට ගිණුමේ සම්පත් වෙත ළඟා විය හැක.
/tt_user/token_info/get/ ලබා දෙන ගිණුම් ID එක, scope අසලම; Accounts API ඇමතුම්වල business_id ලෙස භාවිතා කළ හැක.
Authorization කේතය යෙදුමට ළඟා වන්නේ කෙසේද?
TikTok ගිණුම් හිමිකරු authorization URL එක හරහාය. එය My Apps, App Detail, Basic Information යටතේ, යෙදුම TikTok Accounts permission එක ලබාගත් පසු, developer යෙදුමක් සඳහා TikTok විසින් ජනනය කරයි. ගිණුම් හිමිකරු එය විවෘත කර permissions සමාලෝචනය කර අනුමත කරයි. ඉන්පසු TikTok browser එක යෙදුමේ redirect URL එක වෙත යවයි, auth_code එක සමඟ, සහ authorization URL එකේ තිබූ state අගය ද සමඟ. එම කේතය විනාඩි 10ක් සහ එක් හුවමාරුවක් සඳහා පමණක් වලංගුයි.
- Redirect URL: නිරපේක්ෂ, https:// වලින් ආරම්භ වන, / වලින් අවසන් වන, query string, anchor හෝ port නැති, අක්ෂර 10 සිට 512 දක්වා දිග.
- එක් යෙදුමකට redirect URL 10 දක්වා, එකකට පමණක් සක්රිය; එකක් සක්රිය කළ විට එයට අදාළ authorization URL එක ජනනය වේ.
- state: විකල්ප අගයක්; TikTok එය redirect එකේදී ආපසු යවයි, CSRF වැළැක්වීමට යෝජනා කරයි.
disable_auto_auth=1: මීට පෙර එම permissions අනුමත කළ හිමිකරුවන්ට සමාලෝචන පිටුව පෙන්වයි; එසේ නොමැති නම් TikTok ඔවුන් ක්ෂණිකව redirect කරයි.
කේතය tokens සඳහා හුවමාරු කරන්නේ කෙසේද?
ඔබේ server එකෙන් 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 එකෙන් ලැබෙන කේතය ය. 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/"
}'Token response එකේ අඩංගු වන්නේ කුමක්ද?
code, message, request_id සහ data ක්ෂේත්ර සහිත JSON object එකකි. code 0 නම් හුවමාරුව සාර්ථකයි, සහ data හි tokens දෙකම සහ ගිණුමේ ID එක ඇත:
access_token: API ඇමතුම් සඳහා කෙටිකාලීන token එක, දිනක් වලංගුයි.token_type: Bearer, TikTok විස්තර කරන්නේ token එක ඇති ඕනෑම අයෙකුට භාවිතා කළ හැකි බවයි.- scope: token එකට ලබා දුන් අවසර, කොමා වලින් වෙන් කළ තනි string එකක්.
expires_in: access token එක කල් ඉකුත් වීමට ඉතිරි තත්පර, TikTok උදාහරණයේ 86400.refresh_token: access අලුත් කරන 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 ඇමතුම්වලදී token යවන්නේ කෙසේද?
Access-Token නම් request header එකකින්, /business/get/ සිට /business/video/publish/ දක්වා Accounts API endpoints මත. ගිණුම business_id හි නම් කර ඇති අතර, එය එම response එකේ open_id වෙත සකසා ඇත. OAuth endpoints ප්රතිලෝමව ක්රියා කරයි: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ සහ /tt_user/oauth2/revoke/ යෙදුමේ client_id සහ client_secret JSON body එකේ ගන්නා අතර Access-Token header එකක් නොගනී.
Access token එක අලුත් කරන්නේ කෙසේද?
/tt_user/oauth2/refresh_token/ වෙත POST කිරීමෙන්, client_id, client_secret, grant_type refresh_token ලෙස සහ ගබඩා කළ refresh_token එක සමඟ. පිළිතුරේ පළමු හුවමාරුවේ ම ක්ෂේත්ර ඇත: නව 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"],
}Access අවලංගු කරන්නේ කෙසේද?
යෙදුමෙන්, /tt_user/oauth2/revoke/ වෙත client_id, client_secret සහ revoke කළ යුතු access_token එක සහිත POST කිරීමෙන්; සාර්ථක වූ විට code 0 සහ හිස් data object එකක් ලැබේ. ගිණුමෙන්, හිමිකරු TikTok යෙදුම විවෘත කර, Settings and privacy, Security, Manage app permissions වෙත ගොස්, යෙදුම තෝරා Remove access තෝරයි. Authorization එක revoke වූ පසු, එම ගිණුම සඳහා TikTok යෙදුමට comment.update events යැවීම නවතී.
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": {}}Token එකක් පරීක්ෂා කරන්නේ කෙසේද?
/tt_user/token_info/get/ වෙත POST කිරීමෙන්, ඒ සඳහා තමන්ගේම permission අවශ්ය නොවේ: app_id සහ access_token යවන්න, data හි app_id, scope සහ creator_id ලැබේ. scope මගින් හිමිකරු ලබා දුන් දේ ලැයිස්තුගත කරයි. creator_id යනු ගිණුමේ යෙදුම්-විශේෂිත ID එක, Accounts API ඇමතුම් business_id ලෙස ගන්නා අගය. ක්ෂේත්රයකට token එකට නොමැති scope අවශ්ය වූ විට TikTok ලේඛන මෙහි යොමු කරයි.
Token වලින් ඇති වන දෝෂ මොනවාද?
TikTok ඒවා response එකේ code ක්ෂේත්රයේ තබයි, සාමාන්යයෙන් HTTP status එක 200 යටතේ, එබැවින් call එකක් විශ්වාස කිරීමට පෙර code පරීක්ෂා කරන්න. Token සහ ඒවායේ හුවමාරුවට අදාළ return codes:
- 40102: access token එක කල් ඉකුත් වී ඇත; එය අලුත් කර නැවත call කරන්න.
- 40103: refresh token එක කල් ඉකුත් වී ඇත; හිමිකරුගේ නව authorization එකකට පමණක් එය ප්රතිස්ථාපනය කළ හැක.
- 40104: request එකේ access token එකක් නොතිබුණි.
- 40105: access token එක අවලංගු හෝ වැරදියි.
- 40107: refresh token එක අවලංගු හෝ වැරදියි, උදාහරණයක් ලෙස කවදාවත් කල් ඉකුත් නොවන Marketing API token එකක් අලුත් කිරීමට යැවූ එක.
- 40110: authorization කේතය අවලංගු කර, දැනටමත් භාවිතා කර, හෝ කල් ඉකුත් වී ඇත.
- 40131: app ID හෝ secret වැරදීම, කල් ඉකුත් කේතය, හෝ අවලංගු/කල් ඉකුත් refresh token එකකින් token endpoints දෙකේ authentication දෝෂයක්.
easyCoexistence ඔබ වෙනුවෙන් කුමක් අලුත් කරයිද?
පුරනය වීමෙන් පසු සියල්ල. TikTok redirect කරන විගසම easyCoexistence කේතය හුවමාරු කර, token දෙකම encrypted ලෙස ගබඩා කර, access token එක තමන්ම අලුත් කරයි: විනාඩි 15ට අඩු ඉතිරි වූ විට call එකට පෙර, සහ ගිණුම් සෑම පැය 6කට වරක් පමණ පරීක්ෂා කරන විට පැය 8ට අඩු ඉතිරි වූ විට. සෑම අලුත් කිරීමකදීම නව refresh token එක සහ එහි කල් ඉකුත් වීම ගබඩා වන අතර, එකවර පැමිණෙන call එක් අලුත් කිරීමක් බෙදා ගනී.
- ප්රතික්ෂේප වූ token: TikTok 40102, 40104 හෝ 40105 ලෙස පිළිතුරු දුන් විට, සම්බන්ධතාවය නැවත සම්බන්ධ කිරීමට ලකුණු වන අතර හිමිකරුට email එකක් ලැබේ; Partner API පරිශීලකයන්ට channel.disconnected ද ලැබේ.
- ඔබේම කේතය:
get_social_credentials, හෝ Partner API හි GET /channels/{id}?credentials=1,token_expires_atසමඟ වර්තමාන token එක ලබා දෙයි, එබැවින් එක් එක් job එකට වෙන්ව ලබාගන්න. - ඉවත් කිරීම: dashboard එකේ සම්බන්ධතාවය ඉවත් කිරීම, හෝ DELETE /channels/{id} සමඟ, /
tt_user/oauth2/revoke/ හරහා TikTok හි token එක revoke කරයි.
සාමාන්ය වැරදි
- බ්රව්සරයේ authorization කේතය හුවමාරු කිරීම. හුවමාරුව client_secret යවන බැවින්, එය redirect එකෙන් විනාඩි 10ක් ඇතුළත ඔබේ server එකෙන් කරන්න.
- expires_in දිනයක් ලෙස කියවීම. එයට ඇත්තේ ඉතිරි තත්පර, එබැවින් token එක කල් ඉකුත් වන වේලාව දැනගැනීමට එය response කාලයට එකතු කරන්න.
- refresh token සමඟ revoke කිරීම. /tt_user/oauth2/revoke/ ගන්නේ access_token එක, යෙදුමේ client_id සහ client_secret සමඟ ය.
- අවසර තිරය නොමැති වීම අසාර්ථකතාවක් ලෙස සැලකීම. හිමිකරු පෙර අනුමත කළ permissions සඳහා TikTok සමාලෝචන පිටුව මඟ හරියි; එය නැවත පෙන්වීමට disable_auto_auth=1 එකතු කරන්න.
එවිට Claude, ChatGPT හෝ ඔබේම කේතය වර්තමාන token එකකින් TikTok ඇමතුම් කරයි, get_social_credentials මගින් ඔබේ scripts වෙත ලබා දෙයි. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
TikTok API for Business access token එක කොපමණ කාලයක් වලංගුද?
පැය 24ක්. සෑම token ප්රතිචාරයකම expires_in හි ඉතිරි තත්පර දැක්වෙන අතර, වසරක් වලංගු refresh token එක එය අලුත් කරයි.
TikTok refresh endpoint එකට redirect_uri අවශ්යද?
එහි parameter වගුවේ client_id, client_secret, grant_type සහ refresh_token ලැයිස්තුගත කර ඇති අතර redirect_uri නැත. කෙසේ වෙතත්, TikTok authentication මාර්ගෝපදේශය කියන්නේ token endpoints වලට redirect_uri අවශ්ය බවයි.
TikTok token එක revoke කිරීමෙන් webhook එක නවතිනවාද?
ඔව්. හිමිකරු යෙදුම නැවත අනුමත කරන තෙක් TikTok එම ගිණුම සඳහා යෙදුමට comment.update events තවත් යවන්නේ නැත.
TikTok business_id එන්නේ කොහෙන්ද?
token response එකේ open_id වෙතින්, එය Accounts API ඇමතුම් business_id ලෙස ගනී. /tt_user/token_info/get/ එම ID එකම creator_id ලෙස ලබා දෙයි.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ