Tokeny dostępu TikTok API for Business: 24 godziny, odnawianie i cofanie
Token dostępu TikTok API for Business działa 24 godziny i przekazywany jest w nagłówku Access-Token. Aplikacja uzyskuje go, wymieniając kod autoryzacji właściciela pod adresem /tt_user/oauth2/token/, razem z tokenem odświeżania ważnym rok, który odnawia dostęp pod adresem /tt_user/oauth2/refresh_token/. Możesz go cofnąć pod /tt_user/oauth2/revoke/, a listę przyznanych zakresów sprawdzić pod /tt_user/token_info/get/.
easyCoexistence wymienia kod, gdy konto TikTok się loguje, odnawia 24-godzinny token, zanim wygaśnie, i sprawdza konto mniej więcej co 6 godzin, dzięki czemu Claude, ChatGPT lub Twój własny kod wywołują TikTok z aktualnym tokenem, który get_social_credentials przekazuje Twoim skryptom.
Czas ważności tokenu dostępu konta TikTok; każda odpowiedź z tokenem podaje w expires_in liczbę pozostałych sekund.
Ważność tokenu odświeżania wydanego razem z nim; refresh_token_expires_in podaje pozostałe sekundy.
Jak długo kod autoryzacji z przekierowania pozostaje ważny; można go wymienić tylko jeden raz.
Identyfikator aplikacji dla konta, zwracany z każdym tokenem i wysyłany jako business_id w wywołaniach Accounts API.
token_type zwracany przez TikTok: każdy, kto posiada token, może z jego pomocą uzyskać dostęp do zasobów konta.
ID konta, które /tt_user/token_info/get/ zwraca obok zakresu tokenu; można go użyć jako business_id w wywołaniach Accounts API.
Jak kod autoryzacji trafia do Twojej aplikacji?
Przez adres autoryzacji właściciela konta TikTok, który TikTok generuje dla aplikacji dewelopera w sekcji My Apps, App Detail, Basic Information, gdy aplikacja ma uprawnienie TikTok Accounts. Właściciel konta go otwiera, przegląda uprawnienia i je zatwierdza. TikTok przekierowuje wtedy przeglądarkę na adres przekierowania aplikacji, dopisując auth_code oraz wartość state, jeśli adres autoryzacji ją zawierał. Kod jest ważny 10 minut i wystarcza na jedną wymianę.
- Adres przekierowania: bezwzględny, zaczyna się od https://, kończy się znakiem /, bez ciągu zapytania, kotwicy ani portu, a jego długość wynosi od 10 do 512 znaków.
- Do 10 adresów przekierowania na aplikację, jeden aktywny naraz; aktywacja jednego generuje jego własny adres autoryzacji.
- state: opcjonalna wartość, którą TikTok odsyła przy przekierowaniu; TikTok sugeruje ją jako zabezpieczenie przed CSRF.
disable_auto_auth=1: pokazuje stronę przeglądu właścicielom, którzy wcześniej zatwierdzili te same uprawnienia, a których TikTok inaczej przekierowuje od razu.
Jak wymienić kod na tokeny?
Wysyłając z serwera POST na /tt_user/oauth2/token/ w formacie JSON. client_id i client_secret to App ID i Secret widoczne w sekcji My Apps, App Detail, Basic Information; grant_type ma wartość authorization_code; auth_code to kod z przekierowania; a redirect_uri musi być równy adresowi przekierowania konta TikTok ustawionemu w aplikacji.
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/"
}'Co zawiera odpowiedź z tokenami?
Obiekt JSON z polami code, message, request_id i data. Kod 0 oznacza, że wymiana się udała, a data zawiera oba tokeny i identyfikator konta:
access_token: krótkotrwały token do wywołań API, ważny jeden dzień.token_type: Bearer, który TikTok opisuje jako możliwy do użycia przez każdego, kto posiada token.- scope: uprawnienia przyznane tokenowi, jako jeden ciąg oddzielony przecinkami.
expires_in: liczba sekund pozostałych do wygaśnięcia tokenu dostępu, w przykładzie TikTok 86400.refresh_token: token odnawiający dostęp, ważny rok; TikTok zaleca jego zachowanie.refresh_token_expires_in: liczba sekund pozostałych do wygaśnięcia tokenu odświeżania.open_id: identyfikator konta TikTok specyficzny dla aplikacji.
{
"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>"
}
}Jak token wysyła się w wywołaniach API?
W nagłówku HTTP o nazwie Access-Token, w endpointach Accounts API od /business/get/ do /business/video/publish/, a konto wskazuje się w business_id, ustawionym na open_id z tej samej odpowiedzi. Endpointy OAuth działają odwrotnie: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ i /tt_user/oauth2/revoke/ przyjmują client_id i client_secret aplikacji w treści JSON i nie wymagają nagłówka Access-Token.
Jak odnowić token dostępu?
Wysyłając POST na /tt_user/oauth2/refresh_token/ z client_id, client_secret, grant_type ustawionym na refresh_token i zapisanym refresh_token. Odpowiedź ma te same pola co pierwsza wymiana: nowy access_token z expires_in, refresh_token do zachowania na następne odnowienie i liczbę sekund, jaką ten token ma jeszcze do końca. Zaplanuj odnowienie z wyprzedzeniem 24 godzin, zamiast czekać na błąd 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"],
}Jak cofnąć dostęp?
Z poziomu aplikacji przez POST na /tt_user/oauth2/revoke/ z client_id, client_secret i access_token do cofnięcia; sukces zwraca code 0 i pusty obiekt data. Z poziomu konta właściciel otwiera aplikację TikTok, przechodzi do „Ustawienia i prywatność”, „Bezpieczeństwo”, „Zarządzaj uprawnieniami aplikacji”, wybiera aplikację i klika „Usuń dostęp”. Po cofnięciu autoryzacji TikTok przestaje wysyłać aplikacji zdarzenia comment.update dla tego konta.
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": {}}Jak sprawdzić token?
Wystarczy POST na /tt_user/token_info/get/, który nie wymaga własnego uprawnienia: podajesz app_id i access_token, a data zwraca app_id, scope i creator_id. scope to lista tego, co właściciel przyznał, a creator_id to identyfikator konta specyficzny dla aplikacji, czyli wartość, którą wywołania Accounts API przyjmują jako business_id. Dokumentacja TikTok kieruje tu deweloperów zawsze, gdy pole wymaga zakresu, którego token może nie mieć.
Jakie błędy pochodzą z tokenów?
TikTok umieszcza je w polu code odpowiedzi, zwykle przy statusie HTTP 200, więc sprawdź code, zanim uznasz wywołanie za udane. Kody zwracane przy tokenach i ich wymianie:
- 40102: token dostępu wygasł; odnów go i wywołaj ponownie.
- 40103: token odświeżania wygasł; zastąpić go może tylko ponowna autoryzacja przez właściciela.
- 40104: żądanie nie zawierało tokenu dostępu.
- 40105: token dostępu jest nieprawidłowy lub błędny.
- 40107: token odświeżania jest nieprawidłowy lub błędny, na przykład wysłany do odnowienia tokenu Marketing API, który nigdy nie wygasa.
- 40110: kod autoryzacji został anulowany, już użyty lub wygasł.
- 40131: błąd uwierzytelnienia na obu endpointach tokenów, z powodu błędnego App ID lub sekretu, wygasłego kodu albo nieprawidłowego lub wygasłego tokenu odświeżania.
Co easyCoexistence odnawia za Ciebie?
Wszystko po logowaniu. easyCoexistence wymienia kod, gdy TikTok przekieruje z powrotem, zapisuje oba tokeny w formie zaszyfrowanej i sam odnawia token dostępu: przed wywołaniem, gdy zostało mniej niż 15 minut, oraz podczas sprawdzania, które uruchamia dla każdego konta mniej więcej co 6 godzin, gdy zostało mniej niż 8 godzin. Każde odnowienie zapisuje nowy token odświeżania i jego termin ważności, a wywołania nadchodzące razem współdzielą jedno odnowienie.
- Odrzucony token: gdy TikTok odpowie 40102, 40104 lub 40105, połączenie zostaje oznaczone do ponownego połączenia, a właściciel dostaje e-mail; użytkownicy Partner API otrzymują także channel.disconnected.
- Własny kod:
get_social_credentialsalbo GET /channels/{id}?credentials=1 w Partner API zwraca bieżący token ztoken_expires_at, więc pobieraj go przy każdym zadaniu. - Usunięcie: usunięcie połączenia w panelu lub przez DELETE /channels/{id} cofa token w TikTok przez /
tt_user/oauth2/revoke/.
Typowe błędy
- Wymiana kodu autoryzacji w przeglądarce. Wymiana wysyła client_secret aplikacji, więc wykonaj ją po stronie serwera, w ciągu 10 minut od przekierowania.
- Odczytywanie expires_in jako daty. Pole zawiera liczbę pozostałych sekund, więc dodaj ją do czasu odpowiedzi, by poznać moment wygaśnięcia tokenu.
- Cofanie tokenem odświeżania. /tt_user/oauth2/revoke/ przyjmuje access_token wraz z client_id i client_secret aplikacji.
- Uznawanie braku ekranu zgody za błąd. TikTok pomija stronę przeglądu uprawnień, które właściciel zatwierdził wcześniej; dopisz disable_auto_auth=1, aby ją wyświetlić ponownie.
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z liczbą dodanych połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Jak długo działa token dostępu TikTok API for Business?
24 godziny. Każda odpowiedź z tokenami podaje w expires_in liczbę pozostałych sekund, a token odświeżania, ważny rok, go odnawia.
Czy endpoint odświeżania TikTok wymaga redirect_uri?
Tabela parametrów wymienia client_id, client_secret, grant_type i refresh_token, bez redirect_uri, choć przewodnik TikTok po uwierzytelnianiu mówi, że endpointy tokenów wymagają redirect_uri.
Czy cofnięcie tokenu TikTok zatrzymuje webhooki?
Tak. TikTok nie wysyła aplikacji więcej zdarzeń comment.update dla tego konta, dopóki właściciel ponownie nie autoryzuje aplikacji.
Skąd bierze się business_id w TikTok?
Z open_id w odpowiedzi z tokenami, którą wywołania Accounts API przyjmują jako business_id. /tt_user/token_info/get/ zwraca ten sam identyfikator jako creator_id.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w