Token za akaunti za TikTok API for Business: saa 24, kufanya upya na kubatilisha
Token ya ufikiaji ya TikTok API for Business hudumu saa 24 na husafiri katika header ya Access-Token. Programu hupata token hiyo kwa kubadilisha msimbo wa idhini wa mmiliki kwenye /tt_user/oauth2/token/, pamoja na refresh token inayodumu mwaka mmoja na inayofanya upya ufikiaji kupitia /tt_user/oauth2/refresh_token/. Ibatilishe kwenye /tt_user/oauth2/revoke/, na orodheshe wigo uliopewa kwenye /tt_user/token_info/get/.
easyCoexistence inabadilisha msimbo akaunti ya TikTok inapoingia, inafanya upya token ya saa 24 kabla haijaisha na kukagua akaunti takriban kila saa 6, ili Claude, ChatGPT au msimbo wako uite TikTok ukitumia token ya sasa, ambayo get_social_credentials inakabidhi kwa scripts zako.
Muda wa kuishi wa access token ya akaunti ya TikTok; kila jibu la token linaeleza sekunde zilizobaki kwenye expires_in.
Uhalali wa refresh token inayotolewa nayo; refresh_token_expires_in inatoa sekunde zake zilizobaki.
Muda ambao msimbo wa idhini kwenye redirect unabaki halali; unaweza kubadilishwa mara moja tu.
Kitambulisho mahususi cha programu ya akaunti, kinachorudishwa na kila token na kutumwa kama business_id kwenye maombi ya Accounts API.
token_type ambayo TikTok inarudisha: yeyote anayeshika token anaweza kutumia kufikia rasilimali za akaunti.
ID ya akaunti ambayo /tt_user/token_info/get/ inarudisha pamoja na wigo wa token, inayoweza kutumika kama business_id kwenye maombi ya Accounts API.
Msimbo wa idhini unamfikiaje programu yako?
Kupitia URL ya idhini ya mmiliki wa akaunti ya TikTok, ambayo TikTok hutengeneza kwa programu ya msanidi chini ya Programu zangu, Maelezo ya programu, Maelezo ya msingi mara programu inapokuwa na ruhusa ya TikTok Accounts. Mmiliki wa akaunti anaifungua, anakagua ruhusa hizo na kuziidhinisha. Kisha TikTok inapeleka kivinjari kwenye redirect URL ya programu ikiwa na auth_code iliyoambatishwa, pamoja na thamani yoyote ya state ambayo URL ya idhini ilibeba, na msimbo huo ni halali kwa dakika 10 na kubadilishwa mara moja tu.
- Redirect URL: kamili, inaanza na https://, inamalizia kwa /, bila query string, anchor wala port, na urefu wa herufi 10 hadi 512.
- Hadi redirect URL 10 kwa kila programu, moja tu ikiwa hai kwa wakati mmoja; kuamilisha moja kunatengeneza URL yake ya idhini.
- state: thamani ya hiari ambayo TikTok inarudia kwenye redirect, ambayo inapendekeza kama kinga dhidi ya CSRF.
disable_auto_auth=1: inaonyesha ukurasa wa mapitio kwa wamiliki walioidhinisha ruhusa zile zile awali, ambao TikTok vinginevyo huwaelekeza moja kwa moja.
Unabadilishaje msimbo kupata token?
Kwa ombi la POST kwenda /tt_user/oauth2/token/ kutoka seva yako, kama JSON. client_id na client_secret ni Kitambulisho cha programu na Secret zinazoonekana chini ya Programu zangu, Maelezo ya programu, Maelezo ya msingi; grant_type ni authorization_code; auth_code ni msimbo kutoka kwenye redirect; na redirect_uri lazima ilingane na URL ya redirect ya mmiliki wa akaunti ya TikTok iliyowekwa kwenye programu.
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/"
}'Jibu la token lina nini?
Kitu cha JSON chenye code, message, request_id na data. Code ya 0 inamaanisha ubadilishaji umefanikiwa, na data inabeba token zote mbili pamoja na ID ya akaunti:
access_token: token fupi kwa maombi ya API, halali kwa siku moja.token_type: Bearer, ambayo TikTok inaieleza kama inayoweza kutumiwa na yeyote anayeimiliki token.- scope: ruhusa alizopewa token, kama mfuatano mmoja uliotenganishwa kwa koma.
expires_in: sekunde zilizosalia kabla access token kuisha, 86400 katika mfano wa TikTok.refresh_token: token inayofanya upya ufikiaji, halali kwa mwaka mmoja; ushauri wa TikTok ni kuihifadhi.refresh_token_expires_in: sekunde zilizosalia kabla refresh token kuisha.open_id: kitambulisho mahususi cha programu cha akaunti ya TikTok.
{
"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>"
}
}Token inatumwaje kwenye maombi ya API?
Katika header inayoitwa Access-Token, kwenye endpoints za Accounts API kuanzia /business/get/ hadi /business/video/publish/, wakati akaunti yenyewe inatajwa kwenye business_id, ikiwekwa sawa na open_id kutoka jibu hilo hilo. Endpoints za OAuth zinaenda kinyume: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ na /tt_user/oauth2/revoke/ zinachukua client_id na client_secret ya programu kwenye JSON body, na si header ya Access-Token.
Unafanyaje upya access token?
Kwa ombi la POST kwenda /tt_user/oauth2/refresh_token/ lenye client_id, client_secret, grant_type iliyowekwa kuwa refresh_token, na refresh_token iliyohifadhiwa. Jibu lina sehemu zile zile za ubadilishaji wa kwanza: access_token mpya yenye expires_in yake, refresh_token ya kuhifadhi kwa ufanyaji upya ujao, na sekunde zilizosalia kwake. Panga ufanyaji upya kabla ya saa 24 badala ya kusubiri hitilafu 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"],
}Unabatilishaje ufikiaji?
Kutoka kwenye programu, kwa ombi la POST kwenda /tt_user/oauth2/revoke/ lenye client_id, client_secret na access_token ya kubatilisha; mafanikio yanarudisha code 0 na kitu tupu cha data. Kutoka kwenye akaunti, mmiliki anafungua programu ya TikTok, anaenda Mipangilio, Faragha, Usalama, Dhibiti ruhusa za programu, anachagua programu na kuchagua Ondoa ufikiaji. Idhini ikishabatilishwa, TikTok inaacha kutuma matukio ya comment.update kwa programu kwa akaunti hiyo.
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": {}}Unakaguaje token?
Kwa ombi la POST kwenda /tt_user/token_info/get/, ambalo halihitaji ruhusa yake yenyewe: tuma app_id na access_token, na data itarudisha app_id, scope na creator_id. scope inaorodhesha alichoidhinisha mmiliki, na creator_id ni kitambulisho mahususi cha akaunti, thamani ambayo maombi ya Accounts API huchukua kama business_id. Nyaraka za TikTok zinaelekeza wasanidi hapa kila sehemu inapohitaji wigo ambao token inaweza kukosa.
Ni hitilafu zipi zinatokana na token?
TikTok huziweka kwenye sehemu ya code ya jibu, mara nyingi chini ya HTTP status 200, kwa hiyo angalia code kabla ya kuamini ombi. Thamani za kurejesha zinazohusiana na token na ubadilishaji wake:
- 40102: access token imeisha muda; ifanye upya kisha utume ombi tena.
- 40103: refresh token imeisha muda; ni idhini mpya tu kutoka kwa mmiliki inayoibadilisha.
- 40104: ombi halikuwa na access token.
- 40105: access token si halali au si sahihi.
- 40107: refresh token si halali au si sahihi, kwa mfano moja iliyotumwa kufanya upya token ya Marketing API, ambayo haiishi kamwe.
- 40110: msimbo wa idhini umeghairiwa, umeshatumika au umeisha muda.
- 40131: hitilafu ya uthibitishaji kwenye endpoints mbili za token, kutokana na App ID au secret isiyo sahihi, msimbo ulioisha muda, au refresh token isiyo halali au iliyoisha muda.
easyCoexistence inafanya upya nini kwa ajili yako?
Kila kitu baada ya kuingia. easyCoexistence inabadilisha msimbo mara TikTok inaporudisha kivinjari, inahifadhi token zote mbili kwa usimbaji fiche, na inafanya upya access token yenyewe: kabla ya ombi wakati chini ya dakika 15 zimesalia, na wakati wa ukaguzi unaoendeshwa kwa kila akaunti kila takriban saa 6 wakati chini ya saa 8 zimesalia. Kila ufanyaji upya unahifadhi refresh token mpya na tarehe yake ya kuisha, na maombi yanayofika pamoja yanashiriki ufanyaji upya mmoja.
- Token iliyokataliwa: TikTok ikijibu 40102, 40104 au 40105, muunganisho unawekwa alama ya kuunganishwa tena na mmiliki anapokea barua pepe; watumiaji wa Partner API pia wanapokea channel.disconnected.
- Msimbo wako mwenyewe:
get_social_credentials, au GET /channels/{id}?credentials=1 kwenye Partner API, inarudisha token ya sasa pamoja natoken_expires_at, kwa hiyo ipate kwa kila kazi. - Kuondoa: kuondoa muunganisho kwenye dashboard, au kwa DELETE /channels/{id}, kunabatilisha token kwa TikTok kupitia /
tt_user/oauth2/revoke/.
Makosa ya kawaida
- Kubadilisha msimbo wa idhini kwenye kivinjari. Ubadilishaji unatuma client_secret ya programu, kwa hiyo ufanye kutoka kwenye seva yako, ndani ya dakika 10 baada ya redirect.
- Kusoma expires_in kama tarehe. Inashikilia sekunde zilizosalia, kwa hiyo iongeze kwenye muda wa jibu ili kujua token inaisha lini.
- Kubatilisha kwa refresh token. /tt_user/oauth2/revoke/ inachukua access_token, pamoja na client_id na client_secret ya programu.
- Kuchukulia skrini ya idhini inayokosekana kama hitilafu. TikTok inaruka ukurasa wa mapitio kwa ruhusa ambazo mmiliki aliidhinisha awali; ongeza disable_auto_auth=1 ili uonyeshe tena.
US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, bei ikipungua unapoongeza miunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Token ya ufikiaji ya TikTok API for Business hudumu kwa muda gani?
Saa 24. Kila jibu la token linatoa sekunde zilizosalia kwenye expires_in, na refresh token, halali kwa mwaka mmoja, inaufanya upya.
Je, endpoint ya kufanya upya ya TikTok inahitaji redirect_uri?
Jedwali lake la vigezo linaorodhesha client_id, client_secret, grant_type na refresh_token, bila redirect_uri, ingawa mwongozo wa uthibitishaji wa TikTok unasema endpoints zake za token zinahitaji redirect_uri.
Je, kubatilisha token ya TikTok kunasimamisha webhook zake?
Ndiyo. TikTok haitumi tena programu matukio ya comment.update kwa akaunti hiyo hadi mmiliki aidhinishe programu tena.
business_id ya TikTok inatoka wapi?
Kutoka open_id kwenye jibu la token, ambayo maombi ya Accounts API huchukua kama business_id. /tt_user/token_info/get/ inarudisha kitambulisho kilekile kama creator_id.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye