Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

24 hours

Czas ważności tokenu dostępu konta TikTok; każda odpowiedź z tokenem podaje w expires_in liczbę pozostałych sekund.

1 year

Ważność tokenu odświeżania wydanego razem z nim; refresh_token_expires_in podaje pozostałe sekundy.

10 minutes

Jak długo kod autoryzacji z przekierowania pozostaje ważny; można go wymienić tylko jeden raz.

open_id

Identyfikator aplikacji dla konta, zwracany z każdym tokenem i wysyłany jako business_id w wywołaniach Accounts API.

Bearer

token_type zwracany przez TikTok: każdy, kto posiada token, może z jego pomocą uzyskać dostęp do zasobów konta.

creator_id

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.

Exchange the authorization code
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.
A token response (scope shortened)
{
  "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.

Renew a TikTok account access token in Python
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.

Revoke a TikTok account access token
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_credentials albo GET /channels/{id}?credentials=1 w Partner API zwraca bieżący token z token_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.
Z EasyCoexistence zrobisz to

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