Pristupni tokeni za TikTok API for Business: 24 sata, osvežavanje i opoziv
Pristupni token za TikTok API for Business traje 24 sata i putuje u zaglavlju Access-Token. Aplikacija ga dobija razmenom vlasnikovog autorizacionog koda na /tt_user/oauth2/token/, zajedno sa tokenom za osvežavanje koji traje godinu dana i obnavlja pristup na /tt_user/oauth2/refresh_token/. Opozovite ga na /tt_user/oauth2/revoke/, a dodeljene dozvole pregledajte na /tt_user/token_info/get/.
easyCoexistence razmenjuje kod kad se TikTok nalog prijavi, obnavlja token od 24 sata pre isteka i proverava nalog otprilike na svakih 6 sati, pa Claude, ChatGPT ili vaš kod pozivaju TikTok sa važećim tokenom, koji get_social_credentials predaje vašim skriptama.
Trajanje pristupnog tokena TikTok naloga; svaki odgovor sa tokenom navodi preostale sekunde u expires_in.
Važenje tokena za osvežavanje izdatog uz njega; refresh_token_expires_in daje preostale sekunde.
Koliko dugo ostaje važeći autorizacioni kod iz preusmeravanja; može se razmeniti samo jednom.
Identifikator naloga specifičan za aplikaciju, vraća se uz svaki token i šalje se kao business_id u pozivima Accounts API-ja.
Vrsta tokena (token_type) koju TikTok vraća: ko poseduje token može da koristi resurse naloga.
ID naloga koji /tt_user/token_info/get/ vraća uz obim tokena, upotrebljiv kao business_id u pozivima Accounts API-ja.
Kako autorizacioni kod stiže do vaše aplikacije?
Preko URL-a za autorizaciju vlasnika TikTok naloga, koji TikTok generiše za aplikaciju za programere u odeljku My Apps, App Detail, Basic Information kada aplikacija dobije dozvolu TikTok Accounts. Vlasnik naloga ga otvara, pregleda dozvole i odobrava ih. Zatim TikTok šalje pregledač na URL za preusmeravanje aplikacije, sa dodatim parametrom auth_code i eventualnom vrednošću state koju je nosio URL za autorizaciju. Taj kod važi 10 minuta i za jednu razmenu.
- URL za preusmeravanje: apsolutan, počinje sa https://, završava se kosom crtom /, bez upitnog niza, sidra ili porta, dužine od 10 do 512 znakova.
- Do 10 URL-ova za preusmeravanje po aplikaciji, jedan aktivan u isto vreme; aktiviranjem jednog generiše se sopstveni URL za autorizaciju.
- state: opciona vrednost koju TikTok vraća pri preusmeravanju, a preporučuje je kao zaštitu od CSRF napada.
disable_auto_auth=1: prikazuje stranicu za pregled vlasnicima koji su ranije odobrili iste dozvole, a koje bi TikTok inače odmah preusmerio.
Kako se kod razmenjuje za tokene?
POST zahtevom na /tt_user/oauth2/token/ sa vašeg servera, u formatu JSON. client_id i client_secret su App ID i Secret prikazani u odeljku My Apps, App Detail, Basic Information; grant_type je authorization_code; auth_code je kod iz preusmeravanja; a redirect_uri mora biti jednak URL-u za preusmeravanje vlasnika TikTok naloga podešenom 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/"
}'Šta sadrži odgovor sa tokenom?
JSON objekat sa poljima code, message, request_id i data. Kod 0 znači da je razmena uspela, a data sadrži oba tokena i ID naloga:
access_token: kratkoročni token za pozive API-ju, važi jedan dan.token_type: Bearer, što TikTok opisuje kao token koji može da koristi svako ko ga poseduje.- scope: dozvole dodeljene tokenu, kao jedan niz odvojen zarezima.
expires_in: preostale sekunde do isteka pristupnog tokena, 86400 u TikTok-ovom primeru.refresh_token: token koji obnavlja pristup, važi godinu dana; TikTok preporučuje da se sačuva.refresh_token_expires_in: preostale sekunde do isteka tokena za osvežavanje.open_id: identifikator TikTok naloga specifičan za aplikaciju.
{
"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 zahteva pod nazivom Access-Token, na Accounts API endpointima od /business/get/ do /business/video/publish/, dok se sam nalog navodi u business_id, postavljen 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 telu JSON zahteva, bez zaglavlja Access-Token.
Kako se pristupni token obnavlja?
POST zahtevom na /tt_user/oauth2/refresh_token/ sa client_id, client_secret, grant_type postavljenim na refresh_token i sačuvanim refresh_token. Odgovor ima ista polja kao prva razmena: novi access_token sa expires_in, refresh_token koji treba sačuvati za sledeće obnavljanje i preostale sekunde njegovog važenja. Zakažite obnavljanje pre isteka 24 sata, umesto 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 se pristup opoziva?
Iz aplikacije, POST zahtevom na /tt_user/oauth2/revoke/ sa client_id, client_secret i access_token koji se opoziva; uspeh vraća code 0 uz prazan objekat data. Iz naloga, vlasnik otvara TikTok aplikaciju, ide na Podešavanja i privatnost, Bezbednost, Upravljanje dozvolama aplikacija, bira aplikaciju i izabere Ukloni pristup. Kada se autorizacija opozove, TikTok prestaje da šalje aplikaciji događaje comment.update za taj nalog.
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 se token proverava?
POST zahtevom na /tt_user/token_info/get/, koji ne traži sopstvenu dozvolu: pošaljite app_id i access_token, a data vraća app_id, scope i creator_id. scope navodi šta je vlasnik odobrio, a creator_id je identifikator naloga specifičan za aplikaciju, vrednost koju pozivi Accounts API-ja uzimaju kao business_id. TikTok u svojoj dokumentaciji upućuje programere ovde kada polje zahteva obim koji token možda nema.
Koje greške potiču od tokena?
TikTok ih upisuje u polje code odgovora, obično uz HTTP status 200, pa proverite code pre nego što verujete pozivu. Kodovi povratnih vrednosti vezani za tokene i njihovu razmenu:
- 40102: pristupni token je istekao; obnovite ga i ponovo pozovite.
- 40103: token za osvežavanje je istekao; zamenjuje ga samo nova autorizacija vlasnika.
- 40104: zahtev nije sadržao pristupni token.
- 40105: pristupni token je neispravan ili netačan.
- 40107: token za osvežavanje je neispravan ili netačan, na primer onaj poslat za obnavljanje tokena Marketing API-ja, koji nikada ne ističe.
- 40110: autorizacioni kod je otkazan, već iskorišćen ili je istekao.
- 40131: greška autentifikacije na dva endpointa za tokene, zbog pogrešnog App ID-ja ili secreta, isteklog koda, ili neispravnog ili isteklog tokena za osvežavanje.
Šta easyCoexistence obnavlja umesto vas?
Sve posle prijave. easyCoexistence razmenjuje kod čim se TikTok vrati na aplikaciju, čuva oba tokena šifrovano i sam obnavlja pristupni token: pre poziva kad preostane manje od 15 minuta, a tokom provere koju izvodi za svaki nalog otprilike na svakih 6 sati, kad preostane manje od 8 sati. Svako obnavljanje čuva novi token za osvežavanje i njegov istek, a pozivi koji stignu zajedno dele jedno obnavljanje.
- Odbijen token: kad TikTok odgovori sa 40102, 40104 ili 40105, veza se označava za ponovno povezivanje, a vlasnik dobija imejl; korisnici Partner API-ja dobijaju i channel.disconnected.
- Vaš kod:
get_social_credentialsili GET /channels/{id}?credentials=1 na Partner API-ju vraća trenutni token satoken_expires_at, pa ga preuzimajte za svaki posao. - Uklanjanje: uklanjanje veze na kontrolnoj tabli ili pomoću DELETE /channels/{id} opoziva token kod TikTok-a preko /
tt_user/oauth2/revoke/.
Česte greške
- Razmena autorizacionog koda u pregledaču. Razmena šalje client_secret aplikacije, pa je izvodite sa servera, u roku od 10 minuta od preusmeravanja.
- Čitanje expires_in kao datuma. Polje sadrži preostale sekunde, pa ih dodajte na vreme odgovora da biste znali kada token ističe.
- Opozivanje tokenom za osvežavanje. /tt_user/oauth2/revoke/ prima access_token, zajedno sa client_id i client_secret aplikacije.
- Smatranje da je izostanak ekrana za saglasnost greška. TikTok preskače stranicu za pregled za dozvole koje je vlasnik ranije odobrio; dodajte disable_auto_auth=1 da je ponovo prikažete.
Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatno.
Često postavljana pitanja
Koliko dugo traje pristupni token TikTok API for Business?
24 sata. Svaki odgovor sa tokenom navodi sekunde preostale u expires_in, a token za osvežavanje, koji važi godinu dana, obnavlja ga.
Da li TikTok endpoint za osvežavanje traži redirect_uri?
Tabela parametara navodi client_id, client_secret, grant_type i refresh_token, bez redirect_uri, iako TikTok-ov vodič za autentifikaciju kaže da njegovi endpointi za tokene zahtevaju redirect_uri.
Da li opoziv TikTok tokena zaustavlja webhookove?
Da. TikTok aplikaciji više ne šalje događaje comment.update za taj nalog dok vlasnik ponovo ne autorizuje aplikaciju.
Odakle dolazi TikTok business_id?
Iz open_id u odgovoru sa tokenom, koji pozivi Accounts API-ja uzimaju kao business_id. /tt_user/token_info/get/ vraća isti ID kao creator_id.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na