Błąd TikTok 40104: token dostępu jest pusty
Błąd TikTok 40104 oznacza, że żądanie przyszło bez tokenu dostępu. Endpointy Accounts API, takie jak /business/video/list/ i /business/comment/list/, oczekują tokenu konta TikTok w nagłówku o nazwie Access-Token. Dodaj ten nagłówek z ważnym tokenem, pobranym z /tt_user/oauth2/token/ lub odnowionym przy użyciu refresh tokenu, i wyślij żądanie ponownie.
easyCoexistence dodaje bieżący token konta TikTok w nagłówku Access-Token do każdego wywołania, które wykonuje dla Claude, ChatGPT lub Twojego kodu.
Kod zwracany przez TikTok, gdy token dostępu jest pusty; naprawa polega na wysłaniu ważnego tokenu.
Wymagany nagłówek, który przenosi token konta TikTok w endpointach Accounts API.
Parametr wskazujący konto TikTok w każdym wywołaniu, ustawiony na open_id zwrócone wraz z tokenem.
Typ tokenu (token_type), jaki TikTok zwraca dla tokenu dostępu konta TikTok; nadal wysyłany w Access-Token.
Co oznacza błąd 40104?
TikTok otrzymał wywołanie bez tokenu dostępu. W załączniku z kodami zwrotnymi 40104 figuruje jako pusty token dostępu, z tym samym rozwiązaniem co pozostałe błędy tokenów: użyj ważnego tokenu dostępu i spróbuj ponownie. Żądanie dotarło do TikTok, ale nie zawierało niczego, co wskazywałoby, w czyim imieniu działa, więc TikTok uznaje wywołanie za nieudane.
Gdzie trafia token?
W nagłówku o nazwie Access-Token. W dokumentacji Accounts API, od publikowania po komentarze i statystyki, Access-Token figuruje jako wymagany nagłówek z tokenem, który autoryzowało konto TikTok. Samo konto wskazuje się osobno, w business_id, ustawionym na open_id zwrócone wraz z tokenem.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","caption","video_views"]'Jak nagłówek zostaje pusty?
Token gubi się między zapisem a żądaniem. Warto sprawdzić te miejsca:
- Nagłówek ma inną nazwę. Token wysłany jako Authorization: Bearer zostawia Access-Token pusty, mimo że TikTok podaje typ tokenu jako Bearer.
- Zmienna z tokenem jest pusta, na przykład po nieudanym odnowieniu, którego błąd nie został sprawdzony.
- Token trafia do treści lub do parametrów zapytania zamiast do nagłówka.
- Pomocnik napisany dla /
tt_user/oauth2/token/ i /tt_user/oauth2/refresh_token/ został użyty ponownie; te endpointy nie przyjmują nagłówka Access-Token, więc pomocnik go nie wysyła.
Jak to naprawić?
Wyślij token w Access-Token, razem z business_id. Jeśli nie ma aktualnego tokenu, zdobądź go: odnów go przez /tt_user/oauth2/refresh_token/, dopóki refresh token jest ważny, albo poproś właściciela konta o ponowną autoryzację aplikacji, jeśli nie jest. Podczas debugowania zapisuj, czy nagłówek jest obecny i jaka jest długość jego wartości, a nie sam token, bo TikTok zaznacza, że każdy, kto ma token, może go użyć.
Typowe błędy
- Traktowanie 40104 jako wygasły token. Token jest nieobecny, a nie stary, więc jego odnawianie nic nie zmieni, dopóki kod faktycznie go nie wyśle.
- Odnowienie tokenu bez przekazania nowego dalej. Odnowienie zwraca nowy token dostępu, a kolejne wywołania muszą wysyłać tę wartość w Access-Token.
- Ponawianie żądania bez zmian. Bez nagłówka każda próba trafia do TikTok w ten sam sposób i dostaje ten sam kod.
Jeśli TikTok mimo to odpowie 40102, 40104 lub 40105, połączenie zostaje od razu oznaczone do ponownego połączenia, a Ty dostajesz e-mail. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami bezpłatnymi.
Najczęściej zadawane pytania
Czy mogę wysłać token dostępu TikTok jako Authorization: Bearer?
Nie. Endpointy Accounts API odczytują token z nagłówka Access-Token, więc token wysłany jako Authorization: Bearer zostawia go pusty, a wywołanie zwraca 40104, mimo że TikTok podaje typ tokenu jako Bearer.
Czy 40104 oznacza to samo co wygasły token?
Nie. 40104 oznacza, że w ogóle nie dotarł żaden token; wygasły zwraca 40102, a nieprawidłowy lub błędny zwraca 40105.
Czy endpointy tokenów TikTok potrzebują Access-Token?
Nie. /tt_user/oauth2/token/ i /tt_user/oauth2/refresh_token/ identyfikują aplikację za pomocą client_id i client_secret w treści żądania.
Czy business_id zastępuje token?
Nie. business_id wskazuje, którego konta TikTok dotyczy wywołanie, a Access-Token przenosi autoryzację do działania w jego imieniu. Każde wywołanie potrzebuje obu.
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