Dlaczego połączenie z TikTok API przestaje działać i jak je utrzymać przy życiu
Połączenie TikTok API for Business przestaje działać, gdy 24-godzinny token dostępu nie zostanie odnowiony, roczny token odświeżania wygaśnie, właściciel odbierze aplikacji dostęp albo wysłany token będzie brakujący lub błędny. TikTok zgłasza przypadki tokenów jako 40102, 40103, 40104 i 40105. Odnawianie z wyprzedzeniem, sprawdzanie każdego konta według harmonogramu oraz proszenie właściciela o ponowną autoryzację przed końcem roku utrzymują połączenie przy życiu.
easyCoexistence utrzymuje każde połączenie z TikTok samodzielnie: odnawia 24-godzinny token z wyprzedzeniem, sprawdza konto mniej więcej co 6 godzin, a gdy TikTok odrzuca token, oznacza kanał jako „Reconnect needed” i wysyła Ci e-mail, dla Claude, ChatGPT lub Twojej własnej platformy.
Czas życia tokenu dostępu do konta TikTok z API for Business; /tt_user/oauth2/refresh_token/ go odnawia.
Czas życia tokenu odświeżania; po jego wygaśnięciu właściciel konta musi ponownie autoryzować aplikację.
Przyczyna błędu, gdy właściciel odbiera aplikacji dostęp w trakcie przetwarzania posta przez TikTok; TikTok zaleca nie ponawiać.
Zdarzenia, które TikTok przestaje wysyłać dla konta po wygaśnięciu lub cofnięciu autoryzacji właściciela.
Dlaczego w TikTok for Developers uruchamia się authorization.removed: użytkownik się rozłącza, konto zostaje usunięte, następuje zmiana wieku, nałożono bana albo deweloper cofa dostęp.
Jak często easyCoexistence sprawdza każde podłączone konto TikTok; sam odnawia 24-godzinny token i wysyła e-mail, gdy trzeba połączyć konto ponownie.
Dlaczego połączenie z TikTok API przestaje działać?
Z kilku powodów, z których większość wiąże się z tokenami konta albo ze zgodą właściciela. Niektóre całkowicie kończą połączenie, a inne zostawiają je połowicznie sprawne, z częścią wywołań odrzucanych, a resztą nadal odpowiadającą:
Jaki błąd zwraca każda przyczyna i co ją naprawia?
Pole code w odpowiedzi TikToka nazywa większość z nich, wewnątrz odpowiedzi HTTP 200, a nie statusu błędu, a status publikacji dodaje własny powód niepowodzenia. 40100 znajduje się w tabeli, ponieważ wywołanie ograniczone przepustowością może wyglądać jak utracone połączenie. Co oznacza każdy z nich i jak go naprawić:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause the endpoint 5 minutes; the token still works |
Jak długo żyją tokeny i kiedy je odnawiać?
W API for Business token dostępu żyje 24 godziny, a expires_in w każdej odpowiedzi tokenu podaje pozostałe sekundy; token odświeżania żyje rok, z własnym odliczaniem w refresh_token_expires_in. Odnawiaj z dużym wyprzedzeniem przed końcem dnia, według harmonogramu, a nie po nieudanym wywołaniu, i zapisuj token odświeżania zwracany przy każdym odnowieniu, ponieważ TikTok zaleca jego zachowanie. Traktuj refresh_token_expires_in jako termin: w przykładzie odnowienia TikToka odlicza czas zamiast zaczynać nowy rok.
Co się dzieje, gdy właściciel odbiera dostęp aplikacji?
Aplikacja traci uprawnienia do Accounts API nadane przez właściciela, więc wywołania z tym tokenem przestają działać, a TikTok nie dokumentuje żadnego zdarzenia API for Business, które by o tym informowało. Właściciel może to zrobić w dowolnym momencie w aplikacji TikTok, w ustawieniach Settings and privacy, Security, Manage app permissions, Remove access. Sygnały pojawiają się gdzie indziej: post, który TikTok przetwarzał, kończy się błędem auth_removed, którego TikTok zaleca nie ponawiać, a zdarzenia comment.update dla konta przestają przychodzić.
Jak zmiana typu konta wpływa na połączenie?
TikTok nie wiąże z tym żadnego błędu tokenu w swojej dokumentacji; zmienia się to, co zwraca API. Dane takie jak unique_video_views, daily_new_followers i audience_activity wymagają Advanced Access lub kont Verified Business Account, podobnie jak API Mentions i API Business Messaging, a privacy_level_options konta prywatnego pomija PUBLIC_TO_EVERYONE. Od 16 października 2026 r. is_business_account jest prawdziwe tylko dla kont Verified Business Account, a has_advanced_access pokazuje Advanced Access, więc odczytanie obu pól pod user.account.type ujawnia zmianę, zanim wywołanie się na niej potknie.
Jak wychwycić martwe połączenie, zanim zrobi to klient?
Sprawdzeniami, które działają niezależnie od tego, czy ktoś publikuje:
- Lekkie wywołanie dla każdego konta według harmonogramu, na przykład /business/get/ z polem username, które zwraca błąd tokenu, gdy token przestaje działać.
- /
tt_user/token_info/get/, które nie wymaga uprawnień i zwraca zakres tokenu, aby potwierdzić, że przyznane uprawnienia nadal obejmują to, czego wymagają Twoje funkcje. refresh_token_expires_inzamienione na datę przy każdej odpowiedzi, z przypomnieniem dla właściciela na kilka tygodni przed terminem.- Cisza w comment.update dla konta, które zwykle dostaje komentarze, ponieważ TikTok przestaje wysyłać te zdarzenia po wygaśnięciu lub cofnięciu autoryzacji.
- Liczba błędów 40102, 40103, 40104 i 40105 liczona dla każdego konta, aby jedno zawodzące konto wyróżniało się wśród wielu.
Jak ponownie połączyć konto?
Uruchamiając autoryzację ponownie dla tego samego konta. Udostępnij adres URL autoryzacji posiadacza konta TikTok, z wartością state, która wiąże powrót z kontem, oraz disable_auto_auth=1, jeśli właściciel ma ponownie zobaczyć stronę uprawnień. Wymień nowy auth_code na /tt_user/oauth2/token/ w ciągu jego 10 minut, a następnie zastąp oba zapisane tokeny. open_id to identyfikator konta specyficzny dla aplikacji w TikTok, więc dopasuj nowe tokeny do zapisanego rekordu po nim, zamiast tworzyć drugi.
Czy połączenia Content Posting API wygasają tak samo?
Nie. TikTok for Developers, który obsługuje Content Posting i Display API, 2 listopada 2026 r. zaktualizował strony o tokenach: tokeny dostępu użytkownika wygasają w ciągu 2 godzin, a tokeny odświeżania wygasają po 180 dniach od pierwszego wydania. Tokeny odświeżania są rotacyjne, więc każde udane odświeżenie zwraca nowy i natychmiast unieważnia wysłany; jeśli serwer nadal używa zastąpionego tokenu, kolejne odświeżenia zawodzą i użytkownik musi autoryzować ponownie. Zły token odświeżania kończy się błędem invalid_grant, zły token dostępu access_token_invalid i HTTP 401, a jego webhook authorization.removed mówi, dlaczego użytkownik odszedł.
Co easyCoexistence robi, by utrzymać połączenie z TikTok?
Odnawia i sprawdza je samodzielnie, a informuje, gdy tylko właściciel może to naprawić:
- Odnowienie: przed wywołaniem, gdy zostało mniej niż 15 minut, oraz podczas sprawdzenia, gdy zostało mniej niż 8 godzin, a każdorazowo zapisanie nowego tokenu odświeżania i jego terminu wygaśnięcia.
- Jedno odnowienie naraz dla każdego konta, więc wywołania przychodzące razem z niego korzystają.
- Sprawdzenie: wywołanie /business/get/ dla nazwy użytkownika konta mniej więcej co 6 godzin.
- Odrzucony token, 40102, 40104 lub 40105: kanał pokazuje „Reconnect needed”, właściciel dostaje jeden e-mail, a platforma otrzymuje channel.disconnected z komunikatem TikToka jako
disconnected_reason. - Do tego czasu narzędzia odpowiadają, że konto wymaga ponownego połączenia, a zaplanowany post kończy się statusem reconnect zamiast trafić do TikToka.
- Ponowne połączenie: Connect TikTok na stronie kanału albo nowa sesja połączenia loguje ponownie i zachowuje ten sam
account_idoraz cel zdarzeń.
Jak to skonfigurować
- Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
- Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
- Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.
Typowe błędy
- Traktowanie cichego webhooka komentarzy jako cichego konta. TikTok przestaje wysyłać comment.update dla konta, gdy kończy się jego autoryzacja, więc sprawdzaj konto zamiast czekać na zdarzenia.
- Ponowne połączenie tworzące nowy rekord. Dopasuj nowe tokeny po open_id, identyfikatorze konta specyficznym dla aplikacji w TikTok, i zaktualizuj zapisany rekord w miejscu, zachowując jego historię i ustawienia.
- Ponawianie 40103 lub 40107 tym samym tokenem odświeżania. Żaden z nich nie ustępuje przy ponowieniu: pierwszy wymaga nowej autoryzacji, drugi tokenu odświeżania z ostatniej odpowiedzi albo nowej autoryzacji.
- Odczytanie 40100 jako utraconego połączenia. To wywołanie ograniczone przepustowością; wstrzymaj endpoint na 5 minut albo do 00:00 UTC po dziennym limicie, a ten sam token dalej działa.
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Czy połączenie z TikTok API może działać bez właściciela w nieskończoność?
Nie. Odnawianie utrzymuje je przez co najwyżej rok żywotności tokenu odświeżania; potem udokumentowaną ścieżką TikToka jest nowa autoryzacja przez właściciela konta.
Dlaczego połączenia z TikTok zawiodły u kilku kont naraz?
Najpierw sprawdź aplikację, a dopiero potem konta: 40113 oznacza, że aplikacja jest zablokowana albo jej ID i sekret się nie zgadzają, a TikTok może cofnąć aplikacji dostęp do Accounts API za nadużycia.
Czy nowa funkcja oznacza konieczność ponownego połączenia kont TikTok?
Gdy wymaga zakresu, którego właściciel nigdy nie nadał, tak. Token zachowuje zakresy zatwierdzone przy autoryzacji, więc aby dodać jeden, właściciel autoryzuje aplikację ponownie.
Co dzieje się z zaplanowanymi postami TikTok, gdy konto wymaga ponownego połączenia?
W easyCoexistence kończą się statusem reconnect o zaplanowanej porze zamiast trafić do TikToka, właściciel dostaje e-mail, a przycisk Retry wysyła je po ponownym połączeniu konta.
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