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 మీ స్క్రిప్ట్లకు అందిస్తుంది.
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 ఖాతా యజమాని అధికార URL ద్వారా, యాప్కు TikTok Accounts అనుమతి ఉన్నప్పుడు డెవలపర్ యాప్ కోసం TikTok దాన్ని నా యాప్లు, యాప్ వివరాలు, ప్రాథమిక సమాచారం కింద జనరేట్ చేస్తుంది. ఖాతా యజమాని దాన్ని తెరిచి, అనుమతులను సమీక్షించి, ఆమోదిస్తారు. తర్వాత TikTok బ్రౌజర్ను యాప్ యొక్క రీడైరెక్ట్ URL కు పంపుతుంది, దానికి auth_code తో పాటు అధికార URL లోని state విలువ కూడా జతచేయబడుతుంది. ఆ కోడ్ 10 నిమిషాల పాటు, ఒక్కసారి మార్పిడికి మాత్రమే చెల్లుతుంది.
- రీడైరెక్ట్ URL: పూర్తి చిరునామా, https:// తో మొదలై / తో ముగుస్తుంది, క్వెరీ స్ట్రింగ్, యాంకర్ లేదా పోర్ట్ లేకుండా, 10 నుండి 512 అక్షరాల పొడవు ఉండాలి.
- ఒక్కో యాప్కు గరిష్టంగా 10 రీడైరెక్ట్ URLలు, ఒకేసారి ఒకటి మాత్రమే యాక్టివ్; ఒకదాన్ని యాక్టివేట్ చేస్తే దానికి సొంత అధికార URL వస్తుంది.
- state: ఐచ్ఛిక విలువ; TikTok దాన్ని రీడైరెక్ట్లో తిరిగి పంపుతుంది, CSRF నుండి రక్షణగా దీన్ని సూచిస్తుంది.
disable_auto_auth=1: ఇంతకు ముందే అదే అనుమతులను ఆమోదించిన యజమానులకు సమీక్ష పేజీ చూపిస్తుంది; లేకపోతే TikTok వారిని వెంటనే రీడైరెక్ట్ చేస్తుంది.
కోడ్ను టోకెన్ల కోసం ఎలా మార్చుకుంటారు?
మీ సర్వర్ నుంచి /tt_user/oauth2/token/ కు JSON రూపంలో POST పంపడం ద్వారా. client_id మరియు client_secret అంటే నా యాప్లు, యాప్ వివరాలు, ప్రాథమిక సమాచారం కింద కనిపించే 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 హెడర్ లేకుండా.
యాక్సెస్ టోకెన్ను ఎలా పునరుద్ధరిస్తారు?
/tt_user/oauth2/refresh_token/ కు POST పంపడం ద్వారా, అందులో client_id, client_secret, grant_type గా refresh_token, మరియు నిల్వ చేసిన refresh_token ఉంటాయి. ప్రతిస్పందనలో మొదటి మార్పిడిలోని అవే ఫీల్డ్లు ఉంటాయి: దాని expires_in తో కొత్త access_token, తదుపరి పునరుద్ధరణ కోసం ఉంచాల్సిన 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 యాప్ తెరిచి, సెట్టింగ్లు మరియు గోప్యత, భద్రత, యాప్ అనుమతులను నిర్వహించండి కు వెళ్లి, యాప్ను ఎంచుకుని, యాక్సెస్ తీసివేయండి ఎంచుకుంటారు. అధికారం రద్దు అయిన తర్వాత, ఆ ఖాతాకు 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 రిఫరెన్స్లు డెవలపర్లను ఇక్కడికే పంపుతాయి.
టోకెన్ల వల్ల వచ్చే లోపాలు ఏవి?
TikTok వాటిని ప్రతిస్పందనలోని code ఫీల్డ్లో ఉంచుతుంది, సాధారణంగా HTTP స్టేటస్ 200 కింద, కాబట్టి కాల్ను నమ్మే ముందు code ను తనిఖీ చేయండి. టోకెన్లు మరియు వాటి మార్పిడితో ముడిపడిన రిటర్న్ కోడ్లు:
- 40102: యాక్సెస్ టోకెన్ గడువు ముగిసింది; దాన్ని పునరుద్ధరించి మళ్లీ కాల్ చేయండి.
- 40103: రిఫ్రెష్ టోకెన్ గడువు ముగిసింది; యజమాని కొత్తగా అధికారం ఇచ్చినప్పుడు మాత్రమే అది మారుతుంది.
- 40104: అభ్యర్థనలో యాక్సెస్ టోకెన్ లేదు.
- 40105: యాక్సెస్ టోకెన్ చెల్లనిది లేదా తప్పు.
- 40107: రిఫ్రెష్ టోకెన్ చెల్లనిది లేదా తప్పు; ఉదాహరణకు Marketing API టోకెన్ను పునరుద్ధరించడానికి పంపిన రిఫ్రెష్ టోకెన్, ఎందుకంటే Marketing API టోకెన్ ఎప్పటికీ గడువు ముగియదు.
- 40110: అధికార కోడ్ రద్దు అయింది, ఇప్పటికే ఉపయోగించబడింది లేదా గడువు ముగిసింది.
- 40131: రెండు టోకెన్ ఎండ్పాయింట్ల వద్ద ప్రామాణీకరణ లోపం; తప్పు యాప్ ID లేదా సీక్రెట్, గడువు ముగిసిన కోడ్, లేదా చెల్లని లేదా గడువు ముగిసిన రిఫ్రెష్ టోకెన్ వల్ల.
easyCoexistence సైన్-ఇన్ తర్వాత మీ కోసం ఏమి పునరుద్ధరిస్తుంది?
సైన్-ఇన్ తర్వాత అన్నీ. TikTok మిమ్మల్ని తిరిగి రీడైరెక్ట్ చేసిన వెంటనే easyCoexistence కోడ్ను మార్చుకుంటుంది, రెండు టోకెన్లనూ ఎన్క్రిప్ట్ చేసి నిల్వ చేస్తుంది, మరియు యాక్సెస్ టోకెన్ను స్వయంగా పునరుద్ధరిస్తుంది: కాల్ చేయడానికి ముందు 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 ను తేదీగా చదవడం. అది మిగిలిన సెకన్లను ఇస్తుంది, కాబట్టి టోకెన్ ఎప్పుడు గడువు ముగుస్తుందో తెలుసుకోవడానికి ప్రతిస్పందన సమయానికి దాన్ని కలపండి.
- రిఫ్రెష్ టోకెన్తో రద్దు చేయడం. /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 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ