TikTok API for Business pristupni tokeni: 24 sata, osvježavanje i opoziv
Pristupni token TikTok API for Business traje 24 sata i šalje se u zaglavlju Access-Token. Aplikacija ga dobiva razmjenom autorizacijskog koda vlasnika na /tt_user/oauth2/token/, zajedno s tokenom za osvježavanje koji traje godinu dana i obnavlja pristup na /tt_user/oauth2/refresh_token/. Opozovite ga na /tt_user/oauth2/revoke/, a popis odobrenih dozvola pogledajte na /tt_user/token_info/get/.
easyCoexistence razmjenjuje kôd kada se TikTok račun prijavi, obnavlja pristupni token od 24 sata prije nego što istekne i provjerava račun otprilike svakih 6 sati, pa Claude, ChatGPT ili vaš vlastiti kôd pozivaju TikTok s važećim tokenom, koji get_social_credentials predaje vašim skriptama.
Trajanje pristupnog tokena TikTok računa; svaki odgovor s tokenom navodi preostale sekunde u expires_in.
Valjanost tokena za osvježavanje koji se izdaje uz njega; refresh_token_expires_in navodi preostale sekunde.
Koliko dugo vrijedi autorizacijski kôd u preusmjeravanju; može se razmijeniti samo jednom.
Specifični ID računa u aplikaciji, koji se vraća uz svaki token i šalje kao business_id u pozivima Accounts API-ja.
Token_type koji TikTok vraća: tko god posjeduje token može njime pristupiti resursima računa.
ID računa koji /tt_user/token_info/get/ vraća uz opseg tokena, a može se koristiti kao business_id u pozivima Accounts API-ja.
Kako autorizacijski kôd dolazi do vaše aplikacije?
Putem URL-a za autorizaciju vlasnika TikTok računa, koji TikTok generira za aplikaciju programera pod My Apps, App Detail, Basic Information čim aplikacija dobije dozvolu TikTok Accounts. Vlasnik računa otvara ga, pregledava dozvole i odobrava ih. TikTok zatim preusmjerava preglednik na URL za preusmjeravanje aplikacije, uz dodani parametar auth_code i eventualnu vrijednost state iz URL-a za autorizaciju, a taj kôd vrijedi 10 minuta i može se iskoristiti samo jednom.
- URL za preusmjeravanje: apsolutan, počinje s https://, završava kosom crtom, bez niza upita, sidra ili porta, duljine od 10 do 512 znakova.
- Do 10 URL-ova za preusmjeravanje po aplikaciji, jedan aktivan u isto vrijeme; aktivacija jednog stvara vlastiti URL za autorizaciju.
- state: neobavezna vrijednost koju TikTok vraća pri preusmjeravanju, a koju preporučuje kao zaštitu od CSRF-a.
disable_auto_auth=1: prikazuje stranicu za pregled vlasnicima koji su ranije odobrili iste dozvole, a koje bi TikTok inače odmah preusmjerio.
Kako razmijeniti kôd za tokene?
Slanjem POST zahtjeva na /tt_user/oauth2/token/ s vašeg poslužitelja, u formatu JSON. client_id i client_secret su App ID i Secret prikazani pod My Apps, App Detail, Basic Information; grant_type je authorization_code; auth_code je kôd iz preusmjeravanja; a redirect_uri mora biti jednak URL-u za preusmjeravanje računa vlasnika postavljenom u aplikaciji.
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/"
}'Što sadrži odgovor s tokenom?
JSON objekt s poljima code, message, request_id i data. Kôd 0 znači da je razmjena uspjela, a data sadrži oba tokena i ID računa:
access_token: kratkotrajni token za pozive API-ju, valjan jedan dan.token_type: Bearer, za koji TikTok navodi da ga može upotrijebiti svatko tko posjeduje token.- scope: dozvole odobrene tokenu, kao jedan niz odvojen zarezima.
expires_in: broj preostalih sekundi do isteka pristupnog tokena, u TikTokovu primjeru 86400.refresh_token: token za osvježavanje, valjan godinu dana; TikTok napominje da ga treba zadržati.refresh_token_expires_in: broj preostalih sekundi do isteka tokena za osvježavanje.open_id: specifični ID TikTok računa u aplikaciji.
{
"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>"
}
}Kako se token šalje u pozivima API-ju?
U zaglavlju zahtjeva pod nazivom Access-Token, na endpointima Accounts API-ja od /business/get/ do /business/video/publish/, dok se račun navodi u polju business_id, postavljenom na open_id iz istog odgovora. OAuth endpointi rade obrnuto: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ i /tt_user/oauth2/revoke/ primaju client_id i client_secret aplikacije u tijelu JSON-a, a ne zaglavlje Access-Token.
Kako obnoviti pristupni token?
Slanjem POST zahtjeva na /tt_user/oauth2/refresh_token/ s client_id, client_secret, grant_type postavljenim na refresh_token i pohranjenom vrijednošću refresh_token. Odgovor ima ista polja kao prva razmjena: novi access_token s expires_in, refresh_token koji treba zadržati za sljedeću obnovu i broj sekundi koliko mu preostaje. Zakažite obnovu prije isteka 24 sata, umjesto da čekate grešku 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"],
}Kako opozvati pristup?
Iz aplikacije, slanjem POST zahtjeva na /tt_user/oauth2/revoke/ s client_id, client_secret i poljem access_token koje se opoziva; uspjeh vraća kôd 0 i prazan objekt data. Iz računa, vlasnik otvara TikTok aplikaciju, ide na Settings and privacy, Security, Manage app permissions, odabire aplikaciju i bira Remove access. Nakon opoziva autorizacije TikTok prestaje slati aplikaciji događaje comment.update za taj račun.
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": {}}Kako provjeriti token?
Slanjem POST zahtjeva na /tt_user/token_info/get/, za koji nije potrebna zasebna dozvola: pošaljite app_id i access_token, a data vraća app_id, scope i creator_id. scope navodi što je vlasnik odobrio, a creator_id je specifični ID računa u aplikaciji, vrijednost koju Accounts API uzima kao business_id. TikTokova dokumentacija upućuje programere ovamo kad polju treba opseg koji token možda nema.
Koje greške dolaze od tokena?
TikTok ih stavlja u polje code odgovora, obično pod HTTP statusom 200, pa provjerite code prije nego što povjerujete pozivu. Kodovi povratka vezani uz tokene i njihovu razmjenu:
- 40102: pristupni token je istekao; obnovite ga i ponovno pozovite.
- 40103: token za osvježavanje je istekao; samo nova autorizacija vlasnika ga može zamijeniti.
- 40104: zahtjev nije sadržavao pristupni token.
- 40105: pristupni token je nevažeći ili netočan.
- 40107: token za osvježavanje je nevažeći ili netočan, na primjer onaj poslan za obnovu tokena Marketing API-ja, koji nikad ne istječe.
- 40110: autorizacijski kôd je otkazan, već iskorišten ili je istekao.
- 40131: greška autentikacije na oba endpointa za tokene, zbog netočnog App ID-a ili secreta, isteklog koda ili nevažećeg ili isteklog tokena za osvježavanje.
Što easyCoexistence obnavlja umjesto vas?
Sve nakon prijave. easyCoexistence razmjenjuje kôd čim vas TikTok preusmjeri natrag, pohranjuje oba tokena šifrirano i sam obnavlja pristupni token: prije poziva kad preostane manje od 15 minuta te tijekom provjere koju obavlja za svaki račun otprilike svakih 6 sati kad preostane manje od 8 sati. Svaka obnova pohranjuje novi token za osvježavanje i njegov datum isteka, a pozivi koji stignu zajedno dijele jednu obnovu.
- Odbijen token: kada TikTok odgovori 40102, 40104 ili 40105, veza se označava za ponovno povezivanje, a vlasnik dobiva e-poruku; korisnici Partner API-ja primaju i channel.disconnected.
- Vaš kôd:
get_social_credentialsili GET /channels/{id}?credentials=1 na Partner API-ju vraća trenutačni token stoken_expires_at, pa ga dohvaćajte za svaki posao. - Uklanjanje: uklanjanje veze na nadzornoj ploči ili pomoću DELETE /channels/{id} opoziva token kod TikToka putem /
tt_user/oauth2/revoke/.
Uobičajene pogreške
- Razmjena autorizacijskog koda u pregledniku. Razmjena šalje client_secret aplikacije, pa je obavite sa svog poslužitelja, unutar 10 minuta od preusmjeravanja.
- Čitanje expires_in kao datuma. Polje sadrži preostale sekunde, pa ga dodajte vremenu odgovora da biste znali kada token ističe.
- Opoziv s tokenom za osvježavanje. /tt_user/oauth2/revoke/ prima access_token, zajedno s client_id i client_secret aplikacije.
- Smatrati nedostatak ekrana za suglasnost greškom. TikTok preskače stranicu za pregled za dozvole koje je vlasnik ranije odobrio; dodajte disable_auto_auth=1 da je ponovno prikažete.
Od US$ 9 do US$ 0,75 po vezi mjesečno, pri čemu cijena pada kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Koliko dugo traje pristupni token TikTok API for Business?
24 sata. Svaki odgovor s tokenom navodi preostale sekunde u expires_in, a token za osvježavanje, valjan godinu dana, ga obnavlja.
Treba li endpoint za osvježavanje TikToka parametar redirect_uri?
Tablica parametara navodi client_id, client_secret, grant_type i refresh_token, bez redirect_uri, iako TikTokov vodič za autentikaciju kaže da njegovi endpointi za tokene zahtijevaju redirect_uri.
Zaustavlja li opoziv TikTok tokena webhookove?
Da. TikTok aplikaciji više ne šalje događaje comment.update za taj račun dok vlasnik ponovno ne autorizira aplikaciju.
Odakle dolazi TikTok business_id?
Iz open_id u odgovoru na token, koji Accounts API uzima kao business_id. /tt_user/token_info/get/ vraća isti ID kao creator_id.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na