Błąd TikTok 40102: token dostępu wygasł
Błąd TikTok 40102 oznacza, że token dostępu wysłany w żądaniu wygasł, dlatego endpoint trzeba wywołać ponownie z najnowszym tokenem. Token dostępu z Accounts API jest ważny jeden dzień. Odnów go, wysyłając token odświeżania na /tt_user/oauth2/refresh_token/, a następnie powtórz wywołanie. Sam token odświeżania jest ważny rok; po jego upływie właściciel konta autoryzuje aplikację ponownie.
easyCoexistence sam odnawia 24-godzinny token TikTok za pomocą tokenu odświeżania, z wyprzedzeniem przed wygaśnięciem, więc wywołania z Claude, ChatGPT lub Twojego kodu wychodzą z aktualnym tokenem.
Kod zwrotny TikTok dla wygasłego tokenu dostępu; endpoint trzeba wywołać z najnowszym tokenem.
Jak długo ważny jest token dostępu do konta TikTok z Accounts API.
Wartość expires_in w sekundach z przykładowej odpowiedzi TikTok dla nowo wydanego tokenu dostępu.
Jak długo ważny jest token odświeżania; po jego wygaśnięciu właściciel musi autoryzować aplikację ponownie.
Co oznacza błąd 40102?
Token dostępu w nagłówku Access-Token minął termin ważności. Dokument z kodami zwrotnymi TikTok wymienia 40102 jako wygasły token dostępu i wskazuje, że endpoint trzeba wywołać z najnowszym tokenem. Naprawa polega na użyciu ważnego tokenu dostępu i ponowieniu wywołania.
Kod pojawia się w treści odpowiedzi. Większość wywołań API for Business zwraca HTTP 200, a o tym, czy wywołanie się powiodło, decyduje kod zwrotny, nie status.
Jak długo żyje token dostępu TikTok?
Jeden dzień w API for Business. Accounts API wydaje token dostępu do konta TikTok, gdy aplikacja wymienia kod autoryzacji na /tt_user/oauth2/token/. Odpowiedź podaje czas ważności w polu expires_in: w przykładzie TikTok jest to 86 400 sekund. Ta sama odpowiedź zawiera token odświeżania ważny rok, który TikTok zaleca zachować do odnawiania tokenu dostępu. Tokeny użytkownika TikTok for Developers, używane przez Content Posting API, żyją natomiast 2 godziny.
Jak go odnowić?
Wyślij token odświeżania na /tt_user/oauth2/refresh_token/ z ID i sekretem aplikacji oraz grant_type ustawionym na refresh_token. Odpowiedź zawiera nowy token dostępu i nowy token odświeżania: zapisz oba, od tej pory wysyłaj nowy token dostępu w nagłówku Access-Token i powtórz nieudane wywołanie. Odnowienie przed upływem doby sprawia, że wywołania w ogóle nie trafiają do TikTok z wygasłym tokenem.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<SECRET>",
"grant_type": "refresh_token",
"refresh_token": "<REFRESH_TOKEN>"
}'
# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_inKiedy właściciel musi autoryzować ponownie?
Gdy odnowienie nie jest już możliwe. Token odświeżania jest ważny rok, a dokumentacja TikTok mówi, że po jego wygaśnięciu deweloper prosi właściciela konta o ponowną autoryzację aplikacji w procesie autoryzacji. Właściciel może też w każdej chwili cofnąć autoryzację w aplikacji TikTok, w ustawieniach: Ustawienia i prywatność, Bezpieczeństwo, Zarządzaj uprawnieniami aplikacji. Wtedy drogą powrotu jest nowa autoryzacja.
Typowe błędy
- Odnawianie dopiero po nieudanym wywołaniu. Token ważny jeden dzień wygasa każdego dnia, więc odnów go wcześniej i nie dopuść, by wywołania trafiały do TikTok ze starym tokenem.
- Ignorowanie tokenu odświeżania z odpowiedzi na odnowienie. Dokumentacja TikTok zaleca zachować go do następnego odnowienia, więc zapisuj ten, który zwróci każde odnowienie.
- Sprawdzanie tylko statusu HTTP. TikTok zwykle odpowiada HTTP 200 i wpisuje 40102 w polu kodu, więc samo sprawdzenie statusu uzna błąd za sukces.
- Trzymanie kopii tokenu w kilku miejscach. Odnowienie jednej kopii zostawia pozostałe, które dobiegną końca doby i zawiodą z błędem 40102.
Jeśli TikTok mimo to odrzuci token kodem 40102, 40104 lub 40105, połączenie zostaje od razu oznaczone do ponownego połączenia i dostajesz e-mail. Twój kod może pobrać bieżący token z get_social_credentials zamiast trzymać kopię. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami bezpłatnego okresu próbnego.
Najczęściej zadawane pytania
Co oznacza expires_in w odpowiedzi TikTok na token?
To liczba sekund do wygaśnięcia tokenu dostępu: 86 400, czyli jedna doba, w przykładzie TikTok dla nowego tokenu Accounts API. Dodaj ją do czasu odpowiedzi, by wiedzieć, kiedy odnowić token, zanim pojawi się 40102.
Czy wygasły token dostępu TikTok można odnowić?
Tak, dopóki token odświeżania jest ważny. Wyślij go na /tt_user/oauth2/refresh_token/, a TikTok zwróci nowy token dostępu wraz z tokenem odświeżania.
Czy błąd 40102 oznacza, że konto trzeba połączyć ponownie?
Nie sam z siebie. Ważny token odświeżania odnawia dostęp bez udziału właściciela; nowa autoryzacja jest potrzebna dopiero wtedy, gdy token odświeżania wygasł albo właściciel cofnął dostęp.
Dlaczego odpowiedź z HTTP 200 zawiera błąd 40102?
Kody zwrotne TikTok mają pierwszeństwo przed statusem HTTP. Wywołanie uznaje się za udane tylko wtedy, gdy jego kod to 0, niezależnie od tego, co podaje linia statusu.
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