Token-urile de acces TikTok API for Business: 24 de ore, reînnoire și revocare
Un token de acces TikTok API for Business durează 24 de ore și se trimite în antetul Access-Token. Aplicația îl obține schimbând codul de autorizare al titularului contului la /tt_user/oauth2/token/, împreună cu un refresh token valabil un an, care reînnoiește accesul la /tt_user/oauth2/refresh_token/. Îl revocați la /tt_user/oauth2/revoke/, iar permisiunile acordate le listați la /tt_user/token_info/get/.
easyCoexistence schimbă codul când un cont TikTok se autentifică, reînnoiește token-ul de 24 de ore înainte să expire și verifică contul aproximativ la fiecare 6 ore, astfel încât Claude, ChatGPT sau propriul cod apelează TikTok cu un token curent, pe care get_social_credentials îl transmite scripturilor dumneavoastră.
Durata unui token de acces al contului TikTok; fiecare răspuns de token indică secundele rămase în expires_in.
Valabilitatea refresh token-ului emis împreună cu el; refresh_token_expires_in dă secundele rămase.
Cât timp rămâne valabil codul de autorizare din redirecționare; poate fi schimbat o singură dată.
ID-ul specific aplicației al contului, returnat cu fiecare token și trimis ca business_id la apelurile Accounts API.
token_type returnat de TikTok: oricine deține token-ul îl poate folosi pentru a accesa resursele contului.
ID-ul contului returnat de /tt_user/token_info/get/ alături de permisiunile token-ului, utilizabil ca business_id la apelurile Accounts API.
Cum ajunge codul de autorizare la aplicația dumneavoastră?
Prin URL-ul de autorizare al titularului contului TikTok, pe care TikTok îl generează pentru o aplicație creată în My Apps, App Detail, Basic Information, odată ce aplicația deține permisiunea TikTok Accounts. Titularul contului îl deschide, verifică permisiunile și le aprobă. Apoi TikTok trimite browserul la URL-ul de redirecționare al aplicației, cu un auth_code adăugat, plus orice valoare state pe care o avea URL-ul de autorizare. Codul este valabil 10 minute și pentru un singur schimb.
- URL de redirecționare: absolut, începe cu https://, se termină cu /, fără query string, ancoră sau port, și are între 10 și 512 caractere.
- Până la 10 URL-uri de redirecționare pe aplicație, unul activ la un moment dat; activarea unuia generează propriul URL de autorizare.
- state: valoare opțională pe care TikTok o returnează la redirecționare, recomandată ca protecție împotriva CSRF.
disable_auto_auth=1: afișează pagina de verificare pentru titularii care au aprobat deja aceleași permisiuni, pe care TikTok îi redirecționează altfel imediat.
Cum schimbați codul pe token-uri?
Printr-un POST la /tt_user/oauth2/token/ de pe serverul dumneavoastră, în format JSON. client_id și client_secret sunt App ID și Secret afișate la My Apps, App Detail, Basic Information; grant_type este authorization_code; auth_code este codul din redirecționare; iar redirect_uri trebuie să fie identic cu URL-ul de redirecționare al titularului contului setat în aplicație.
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/"
}'Ce conține răspunsul de token?
Un obiect JSON cu code, message, request_id și data. Un code de 0 înseamnă că schimbul a reușit, iar data conține ambele token-uri și ID-ul contului:
access_token: token-ul de scurtă durată pentru apelurile API, valabil o zi.token_type: Bearer, pe care TikTok îl descrie ca utilizabil de oricine deține token-ul.- scope: permisiunile acordate token-ului, sub forma unui șir cu valori separate prin virgulă.
expires_in: secundele rămase până expiră access token-ul, 86400 în exemplul TikTok.refresh_token: token-ul care reînnoiește accesul, valabil un an; TikTok recomandă păstrarea lui.refresh_token_expires_in: secundele rămase până expiră refresh token-ul.open_id: ID-ul specific aplicației al contului 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>"
}
}Cum se trimite token-ul la apelurile API?
Într-un antet de cerere numit Access-Token, la endpoint-urile Accounts API de la /business/get/ până la /business/video/publish/, iar contul este indicat în business_id, setat la open_id din același răspuns. Endpoint-urile OAuth funcționează invers: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ și /tt_user/oauth2/revoke/ primesc client_id și client_secret ale aplicației într-un corp JSON și nu un antet Access-Token.
Cum reînnoiți token-ul de acces?
Printr-un POST la /tt_user/oauth2/refresh_token/ cu client_id, client_secret, grant_type setat la refresh_token și refresh_token-ul salvat. Răspunsul are aceleași câmpuri ca primul schimb: un access_token nou cu expires_in, un refresh_token de păstrat pentru următoarea reînnoire și secundele rămase pentru acesta. Programați reînnoirea înainte de cele 24 de ore, în loc să așteptați eroarea 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"],
}Cum revocați accesul?
Din aplicație, printr-un POST la /tt_user/oauth2/revoke/ cu client_id, client_secret și access_token-ul de revocat; succesul returnează code 0 și un obiect data gol. Din contul TikTok, titularul deschide aplicația TikTok, merge la Settings and privacy, Security, Manage app permissions, alege aplicația și selectează Remove access. După revocare, TikTok nu mai trimite aplicației evenimentele comment.update pentru acel cont.
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": {}}Cum inspectați un token?
Printr-un POST la /tt_user/token_info/get/, care nu necesită o permisiune proprie: trimiteți app_id și access_token, iar data returnează app_id, scope și creator_id. scope listează ce a acordat titularul, iar creator_id este ID-ul specific aplicației al contului, valoarea pe care apelurile Accounts API o primesc ca business_id. Documentația TikTok trimite dezvoltatorii aici ori de câte ori un câmp necesită un scope pe care token-ul ar putea să nu-l aibă.
Ce erori vin de la token-uri?
TikTok le plasează în câmpul code al răspunsului, de obicei cu statusul HTTP 200, așa că verificați code înainte de a avea încredere într-un apel. Codurile de returnare legate de token-uri și de schimbul lor:
- 40102: token-ul de acces a expirat; reînnoiți-l și apelați din nou.
- 40103: refresh token-ul a expirat; doar o nouă autorizare de către titular îl înlocuiește.
- 40104: cererea nu conținea token de acces.
- 40105: token-ul de acces este invalid sau incorect.
- 40107: refresh token-ul este invalid sau incorect, de exemplu unul trimis pentru a reînnoi un token Marketing API, care nu expiră niciodată.
- 40110: codul de autorizare a fost anulat, deja folosit sau a expirat.
- 40131: eroare de autentificare la cele două endpoint-uri de token, din cauza unui ID sau secret de aplicație greșit, a unui cod expirat sau a unui refresh token invalid ori expirat.
Ce reînnoiește easyCoexistence pentru dumneavoastră?
Totul, după autentificare. easyCoexistence schimbă codul imediat ce TikTok redirecționează înapoi, salvează ambele token-uri criptate și reînnoiește singur token-ul de acces: înainte de un apel, când mai sunt mai puțin de 15 minute, și în verificarea care rulează pe fiecare cont la aproximativ 6 ore, când mai sunt mai puțin de 8 ore. Fiecare reînnoire salvează noul refresh token și data sa de expirare, iar apelurile sosite împreună împart o singură reînnoire.
- Token respins: când TikTok răspunde cu 40102, 40104 sau 40105, conexiunea este marcată pentru reconectare, iar titularul primește un e-mail; utilizatorii Partner API primesc și channel.disconnected.
- Codul dumneavoastră:
get_social_credentialssau GET /channels/{id}?credentials=1 din Partner API returnează token-ul curent cutoken_expires_at, deci îl luați pentru fiecare job. - Eliminare: ștergerea conexiunii din dashboard sau cu DELETE /channels/{id} revocă token-ul la TikTok prin /
tt_user/oauth2/revoke/.
Greșeli frecvente
- Schimbarea codului de autorizare în browser. Schimbul trimite client_secret al aplicației, deci faceți-l de pe server, în 10 minute de la redirecționare.
- Citirea lui expires_in drept dată. Valoarea reprezintă secundele rămase, deci adăugați-o la momentul răspunsului ca să știți când expiră token-ul.
- Revocarea folosind refresh token-ul. /tt_user/oauth2/revoke/ primește access_token, împreună cu client_id și client_secret ale aplicației.
- Considerarea absenței ecranului de consimțământ drept eroare. TikTok sare peste pagina de verificare pentru permisiunile aprobate anterior de titular; adăugați disable_auto_auth=1 ca s-o afișați din nou.
De la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, iar primele 3 zile sunt gratuite.
Întrebări frecvente
Cât durează un access token TikTok API for Business?
24 de ore. Fiecare răspuns de token indică secundele rămase în expires_in, iar refresh token-ul, valabil un an, îl reînnoiește.
Endpoint-ul de reînnoire TikTok are nevoie de redirect_uri?
Tabelul de parametri listează client_id, client_secret, grant_type și refresh_token, fără redirect_uri, deși ghidul de autentificare TikTok spune că endpoint-urile de token cer redirect_uri.
Revocarea unui token TikTok oprește webhook-urile?
Da. TikTok nu mai trimite aplicației evenimente comment.update pentru acel cont până când titularul autorizează din nou aplicația.
De unde vine business_id-ul TikTok?
Din open_id din răspunsul de token, pe care apelurile Accounts API îl primesc ca business_id. /tt_user/token_info/get/ returnează același ID drept creator_id.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la