TikTok API සම්බන්ධතාවය ක්රියා නොකරන්නේ ඇයි, සහ එය ක්රියාශීලීව තබා ගන්නේ කෙසේද
TikTok API for Business සම්බන්ධතාවය ක්රියා නොකරයි, එහි 24 පැයක access token එක අලුත් නොකළ විට, වසරක refresh token එක අවසන් වූ විට, හිමිකරු app එකේ ප්රවේශය ඉවත් කළ විට, හෝ යවන token එක නැති හෝ වැරදි විට. TikTok මෙම token හේතු 40102, 40103, 40104 සහ 40105 ලෙස වාර්තා කරයි. කල් තබා අලුත් කිරීම, සෑම ගිණුමක්ම කාලසටහනකට පරීක්ෂා කිරීම සහ වසර අවසන් වීමට පෙර හිමිකරුගෙන් නැවත අවසර ඉල්ලීම එය ක්රියාශීලීව තබයි.
easyCoexistence සෑම TikTok සම්බන්ධතාවයක්ම තනිවම ක්රියාශීලීව තබයි: 24 පැයක token එක කල්තබා අලුත් කරයි, ගිණුම පැය 6කට වරක් පමණ පරීක්ෂා කරයි, සහ TikTok token එක ප්රතික්ෂේප කළ විට channel එක නැවත සම්බන්ධ කිරීම අවශ්යයි ලෙස සලකුණු කර ඔබට ඊමේල් කරයි, Claude, ChatGPT හෝ ඔබේ තමන්ගේ platform සඳහා.
TikTok API for Business හි ගිණුමේ access token එකේ ආයු කාලය; /tt_user/oauth2/refresh_token/ එය අලුත් කරයි.
Refresh token එකේ ආයු කාලය; එය කල් ඉකුත් වූ පසු, ගිණුම් හිමිකරු app එක නැවත අවසර දිය යුතුය.
TikTok post එකක් සැකසෙමින් පවතින අවස්ථාවේ හිමිකරු app එකේ ප්රවේශය ඉවත් කළ විට ඇතිවන fail reason එක; TikTok නැවත උත්සාහ නොකරන ලෙස පවසයි.
ගිණුම් හිමිකරුගේ අවසරය කල් ඉකුත් වූ හෝ අවලංගු වූ පසු TikTok එම ගිණුම සඳහා නතර කරන සිදුවීම්.
TikTok for Developers හි authorization.removed සිදුවන හේතු: පරිශීලකයා විසන්ධි කරයි, ගිණුම මකයි, වයස වෙනස් වෙයි, තහනම් වෙයි, හෝ developer ප්රවේශය අවලංගු කරයි.
easyCoexistence සම්බන්ධ කළ සෑම TikTok ගිණුමක්ම කොපමණ වාර ගණනකට පරීක්ෂා කරයිද: එය 24 පැයක token එක තනිවම අලුත් කර, නැවත සම්බන්ධ කිරීම අවශ්ය නම් ඔබට ඊමේල් කරයි.
TikTok API සම්බන්ධතාවය ක්රියා නොකරන්නේ ඇයි?
හේතු කිහිපයක් ඇත, බොහොමයක් ගිණුමේ token එකට හෝ හිමිකරුගේ එකඟතාවයට සම්බන්ධයි. සමහර ඒවා සම්බන්ධතාවය සම්පූර්ණයෙන් නතර කරයි, අනෙක් ඒවා එය අඩු වශයෙන් ක්රියා කරවයි, ඇමතුම් සමහරක් ප්රතික්ෂේප වන අතර අනෙක් ඒවාට තවමත් පිළිතුරු ලැබේ:
සෑම හේතුවක්ම ලබා දෙන දෝෂය කුමක්ද, සහ එය විසඳන්නේ කෙසේද?
TikTok හි code field එක බොහෝ හේතු නම් කරයි, එය HTTP 200 පිළිතුරක් ඇතුළේ මිස error status එකක නොවේ, සහ publishing status එකට තමන්ගේම fail reason එකක් එකතු වේ. 40100 වගුවේ ඇත්තේ සීමා කළ ඇමතුමක් නැති වූ සම්බන්ධතාවයක් ලෙස පෙනිය හැකි බැවිනි. එක් එක් හේතුවේ අර්ථය සහ විසඳුම:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause the endpoint 5 minutes; the token still works |
Token එක කොපමණ කාලයක් පවතින්නේද, සහ කවදා අලුත් කළ යුතුද?
API for Business හි access token එක පැය 24ක් පවතින අතර, සෑම token response එකකම expires_in මගින් ඉතිරි තත්පර ලබා දෙයි; refresh token එක වසරක් පවතින අතර, එහි තමන්ගේම ඉතිරි කාලය refresh_token_expires_in තුළ ඇත. දිනය අවසන් වීමට බොහෝ කල් පෙර අලුත් කරන්න, අසාර්ථක ඇමතුමකට පසු නොව කාලසටහනකට අනුව, සහ සෑම අලුත් කිරීමකින්ම ලැබෙන refresh token එක ගබඩා කරන්න, මන්ද TikTok එම field එක පිළිබඳ සටහනේ එය රඳවා ගන්නා ලෙස පවසයි. refresh_token_expires_in එක අවසන් දිනයක් ලෙස සලකන්න: TikTok අලුත් කිරීමේ උදාහරණයේ එය නව වසරක් ආරම්භ කරනවා වෙනුවට ඉතිරි කාලය අඩු වේ.
හිමිකරු app එකේ ප්රවේශය ඉවත් කළ විට කුමක් වේද?
app එකට හිමිකරු ලබා දුන් Accounts API අවසරයන් නැති වන අතර, එම token සමඟ ඇමතුම් ක්රියා නොකරයි; API for Business සඳහා එය දන්වන event එකක් TikTok ලේඛනගත කර නැත. හිමිකරුට එය ඕනෑම වේලාවක TikTok app එකේ සැකසුම් සහ රහස්යතාව, ආරක්ෂාව, app අවසර කළමනාකරණය, ප්රවේශය ඉවත් කරන්න යටතේ කළ හැක. සලකුණු වෙනත් තැන්වල පෙනේ: TikTok සැකසෙමින් තිබූ post එකක් auth_removed සමඟ අසාර්ථක වන අතර, එය නැවත උත්සාහ නොකරන ලෙස TikTok පවසයි, සහ එම ගිණුමේ comment.update events ලැබීම නවතී.
ගිණුම් වර්ගය වෙනස් වීමෙන් සම්බන්ධතාවයට කුමක් වේද?
TikTok එයට token දෝෂයක් බැඳ නැත; වෙනස් වන්නේ API එක ලබා දෙන දේයි. unique_video_views, daily_new_followers සහ audience_activity වැනි දත්ත Advanced Access හෝ Verified Business Account අවශ්ය වේ, Mentions සහ Business Messaging APIs ද එසේමය, සහ පුද්ගලික ගිණුමක privacy_level_options හි PUBLIC_TO_EVERYONE නොමැත. 2026 ඔක්තෝබර් 16 සිට, is_business_account සත්ය ලෙස කියවෙන්නේ Verified Business Accounts සඳහා පමණි, has_advanced_access Advanced Access වාර්තා කරයි, එබැවින් user.account.type යටතේ දෙකම කියවීමෙන් ඇමතුමක් අසාර්ථක වීමට පෙර වෙනසක් පෙන්වයි.
ගනුදෙනුකරුට පෙර, නැති වූ සම්බන්ධතාවය ඔබ හඳුනා ගන්නේ කෙසේද?
කවුරුන් හෝ post කරමින් සිටින්නද නැද්ද යන්න නොසලකා ක්රියාත්මක වන පරීක්ෂා සමඟ:
- සෑම ගිණුමකටම කාලසටහනකට අනුව සැහැල්ලු ඇමතුමක්, උදා: username ක්ෂේත්රය සහිත /business/get/, එය token එක ක්රියා නොකරන විට token දෝෂයක් ලබා දෙයි.
- /
tt_user/token_info/get/, එයට අවසරයක් අවශ්ය නොවන අතර token එකේ scope එක ලබා දෙයි, ඔබේ විශේෂාංග ඇමතුම් තවමත් ආවරණය වන බව තහවුරු කිරීමට. refresh_token_expires_inසෑම response එකක් ලැබෙන විට දිනයක් බවට පරිවර්තනය කර, දින කිහිපයකට පෙර හිමිකරුට සිහිකැඳවීමක්.- ගනුදෙනුකරුවන් සාමාන්යයෙන් comment ලබන ගිණුමක comment.update නිහඬ වීම, TikTok අවසරය කල් ඉකුත් වූ හෝ අවලංගු වූ පසු එම events නවතන නිසා.
- 40102, 40103, 40104 සහ 40105 සෑම ගිණුමකට අනුව ගණන් කිරීම, එවිට බොහෝ අතරින් එක අසාර්ථක ගිණුමක් වෙන්ව පෙනේ.
ගිණුමක් නැවත සම්බන්ධ කරන්නේ කෙසේද?
එම ගිණුම සඳහා අවසරය නැවත ක්රියාත්මක කිරීමෙන්. TikTok account holder authorization URL එක බෙදා ගන්න, ආපසු පැමිණීම ගිණුමට බැඳ තබන state අගයක් සමඟ, සහ හිමිකරු නැවත අවසර පිටුව දැකිය යුතු නම් disable_auto_auth=1 සකසන්න. නව auth_code එක එහි මිනිත්තු 10ක් ඇතුළත /tt_user/oauth2/token/ වෙත හුවමාරු කර, ගබඩා කළ token දෙකම ප්රතිස්ථාපනය කරන්න. open_id යනු ගිණුම සඳහා TikTok හි application-specific ID එකයි, එබැවින් දෙවන record එකක් නිර්මාණය කරනවා වෙනුවට නව token ගබඩා කළ record එකට එය අනුව ගළපන්න.
Content Posting API සම්බන්ධතා ද එලෙසම කල් ඉකුත් වේද?
නැත. TikTok for Developers, Content Posting සහ Display APIs සේවා කරයි, 2026 නොවැම්බර් 2 වන දින එහි token පිටු යාවත්කාලීන කළේය: පරිශීලක access token එක පැය 2ක් තුළ කල් ඉකුත් වන අතර refresh token එක පළමු නිකුත් කිරීමේ දින සිට දින 180ක් පවතී. ඒවා භ්රමණය වේ, එබැවින් සෑම සාර්ථක refresh එකකම නව එකක් ලැබී, යවන ලද එක වහාම අවලංගු වේ; server එකක් ප්රතිස්ථාපනය කළ token එකක් තවමත් භාවිත කළහොත්, පසු refresh අසාර්ථක වන අතර පරිශීලකට නැවත අවසර දීමට සිදු වේ. වලංගු නැති refresh token එක invalid_grant සමඟ අසාර්ථක වේ, වලංගු නැති access token එක access_token_invalid සහ HTTP 401 සමඟ, සහ එහි authorization.removed webhook එකෙන් පරිශීලකයා ඉවත් වූ හේතුව පවසයි.
easyCoexistence TikTok සම්බන්ධතාවය ක්රියාශීලීව තබා ගැනීමට කුමක් කරයිද?
එය තනිවම අලුත් කරයි සහ පරීක්ෂා කරයි, හිමිකරුට පමණක් විසඳිය හැකි දෙයක් වූ විට ඔබට දන්වයි:
- අලුත් කිරීම: ඇමතුමකට පෙර මිනිත්තු 15ට අඩු ඉතිරි වන විට, සහ පරීක්ෂාවේදී පැය 8ට අඩු ඉතිරි වන විට, සෑම වාරයකම නව refresh token එක සහ එහි කල් ඉකුත් වීම ගබඩා කරමින්.
- ගිණුමකට එකවර එක් අලුත් කිරීමක් පමණි, එබැවින් එකවර පැමිණෙන ඇමතුම් එය බෙදා ගනී.
- පරීක්ෂාව: ගිණුමේ username සඳහා /business/get/ ඇමතුමක්, විනාඩි 6කට වරක් පමණ.
- ප්රතික්ෂේප කළ token එකක්, 40102, 40104 හෝ 40105: channel එක නැවත සම්බන්ධ කිරීම අවශ්යයි ලෙස කියවන අතර, හිමිකරුට එක් ඊමේලයක් ලැබේ, සහ platform එකකට TikTok හි පණිවිඩය
disconnected_reasonලෙස සමඟ channel.disconnected ලැබේ. - එතෙක්, ගිණුමට නැවත සම්බන්ධ කිරීම අවශ්ය බව මෙවලම් පිළිතුරු දෙයි, සහ නියමිත post එකක් TikTok වෙත ළඟා වෙනුවට reconnect ලෙස අසාර්ථක වේ.
- නැවත සම්බන්ධ කිරීම: channel පිටුවේ TikTok සම්බන්ධ කරන්න, හෝ නව connect session එකක්, නැවත පුරනය වන අතර එම
account_idසහ event destination තබයි.
එය සකසන ආකාරය
- Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
- Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
- Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.
සාමාන්ය වැරදි
- නිහඬ comment webhook එකක් නිහඬ ගිණුමක් ලෙස සැලකීම. TikTok ගිණුමේ අවසරය අවසන් වූ පසු එම ගිණුම සඳහා comment.update නවතයි, එබැවින් events එනතෙක් රැඳී නොසිට ගිණුම පරීක්ෂා කරන්න.
- නව record එකකට නැවත සම්බන්ධ වීම. නව token එක open_id මගින් ගළපන්න, TikTok හි ගිණුම සඳහා application-specific ID එක, සහ ගබඩා කළ record එක එහි ඉතිහාසය සහ සැකසුම් තබාගෙන ස්ථානගතව යාවත්කාලීන කරන්න.
- එම refresh token එක සමඟ 40103 හෝ 40107 නැවත උත්සාහ කිරීම. දෙකම නැවත උත්සාහයෙන් ඉවත් නොවේ: පළමුවැන්නට නව අවසරයක් අවශ්ය වන අතර, දෙවැන්නට නවතම response එකෙන් ලැබෙන refresh token එක හෝ නව අවසරයක් අවශ්ය වේ.
- 40100 නැති වූ සම්බන්ධතාවයක් ලෙස කියවීම. එය සීමා කළ ඇමතුමකි; endpoint එක විනාඩි 5ක් හෝ දෛනික සීමාවක් පසු 00:00 UTC දක්වා විරාම දෙන්න, එවිට එම token එක තවමත් ක්රියා කරයි.
සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන තරමට අඩු වන අතර, පළමු දින 3 trial කාලය නොමිලේ.
නිතර අසන ප්රශ්න
TikTok API සම්බන්ධතාවයක් හිමිකරු නැතිව සදාකාලිකව පැවතිය හැකිද?
නැත. අලුත් කිරීම වැඩිම වශයෙන් refresh token එකේ වසර පුරා එය රැගෙන යයි; ඉන් පසු, TikTok ලේඛනගත මාර්ගය වන්නේ ගිණුම් හිමිකරුගේ නව අවසරයයි.
ගිණුම් කිහිපයකට එකවර TikTok සම්බන්ධතා අසාර්ථක වූයේ ඇයි?
ගිණුම් වලට පෙර app එක බලන්න: 40113 යනු app එක අවහිර වී ඇති බව හෝ එහි ID සහ secret නොගැළපෙන බවයි, සහ අයුතු භාවිතය සඳහා TikTok app එකේ Accounts API ප්රවේශය අවලංගු කළ හැක.
නව විශේෂාංගයක් TikTok ගිණුම් නැවත සම්බන්ධ කිරීම අවශ්ය කරයිද?
හිමිකරු කිසිදා ලබා නොදුන් scope එකක් අවශ්ය වූ විට, ඔව්. token එකක් අවසරයේදී අනුමත කළ scopes තබා ගනී, එබැවින් එකක් එකතු කිරීමට හිමිකරු app එක නැවත අවසර දිය යුතුය.
ගිණුමකට නැවත සම්බන්ධ කිරීම අවශ්ය වන අතර, නියමිත TikTok post වලට කුමක් වේද?
easyCoexistence හි, ඒවා ඒවායේ වේලාවේදී TikTok වෙත ළඟා වෙනුවට reconnect ලෙස අසාර්ථක වේ, හිමිකරුට ඊමේලයක් ලැබේ, සහ ගිණුම නැවත සම්බන්ධ වූ පසු නැවත උත්සාහ කරන්න ඒවා යවයි.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ