Errore TikTok 40104: l'access token è vuoto
L'errore TikTok 40104 indica che la richiesta è arrivata senza access token. Gli endpoint dell'Accounts API, come /business/video/list/ e /business/comment/list/, si aspettano il token dell'account TikTok in un header chiamato Access-Token. Aggiungi questo header con un token valido, ottenuto da /tt_user/oauth2/token/ o rinnovato con il refresh token, e invia di nuovo la richiesta.
easyCoexistence aggiunge il token attuale dell'account TikTok, nell'header Access-Token, a ogni chiamata che fa per Claude, ChatGPT o il tuo codice.
Il codice restituito da TikTok quando l'access token è vuoto; la correzione è inviarne uno valido.
L'header obbligatorio che porta il token dell'account TikTok negli endpoint dell'Accounts API.
Il parametro che indica l'account TikTok in ogni chiamata, impostato sull'open_id restituito insieme al suo token.
Il token_type che TikTok restituisce con un access token di un account TikTok, che continua a essere inviato in Access-Token.
Cosa significa l'errore 40104?
TikTok ha ricevuto la chiamata senza alcun access token. L'appendice dei codici di ritorno elenca 40104 come access token vuoto, con la stessa correzione degli altri errori di token: usa un access token valido e riprova. La richiesta è arrivata a TikTok, ma nulla al suo interno indicava con quale autorizzazione agire, quindi TikTok la considera non riuscita.
Dove va il token?
In un header chiamato Access-Token. I riferimenti dell'Accounts API, dalla pubblicazione ai commenti fino alle statistiche, indicano Access-Token come header obbligatorio che contiene il token autorizzato dall'account TikTok. L'account stesso è indicato a parte, in business_id, impostato sull'open_id ricevuto insieme al token.
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"]'Come finisce vuoto l'header?
Il token si perde tra l'archiviazione e la richiesta. Ecco dove controllare:
- L'header ha un altro nome. Un token inviato come Authorization: Bearer lascia vuoto Access-Token, anche se TikTok indica il tipo del token come Bearer.
- La variabile che contiene il token è vuota, ad esempio dopo un rinnovo fallito senza che il suo errore sia stato controllato.
- Il token viaggia nel body o nella query string invece che nell'header.
- Una funzione di supporto scritta per /
tt_user/oauth2/token/ e /tt_user/oauth2/refresh_token/ viene riutilizzata; quegli endpoint non accettano l'header Access-Token, quindi la funzione non ne invia nessuno.
Come si risolve?
Invia il token in Access-Token, insieme a business_id. Se non c'è un token attuale da inviare, ottienine uno: rinnova con /tt_user/oauth2/refresh_token/ finché il refresh token è valido, oppure chiedi al titolare dell'account di autorizzare di nuovo l'app se non lo è. Durante il debug, registra se l'header è presente e quanto è lungo il suo valore, non il token stesso, perché TikTok avverte che chiunque possieda il token può usarlo.
Errori comuni
- Trattare 40104 come un token scaduto. Il token è assente, non vecchio, quindi rinnovarlo non cambia nulla finché il codice non lo invia davvero.
- Rinnovare il token senza passare quello nuovo. Il rinnovo restituisce un nuovo access token, e le chiamate successive devono inviare quel valore in Access-Token.
- Riprovare la richiesta senza modifiche. Senza l'header, ogni tentativo arriva a TikTok nello stesso modo e riceve lo stesso codice.
Se TikTok risponde comunque con 40102, 40104 o 40105, la connessione viene subito segnalata per la riconnessione e ricevi un'e-mail. Da US$ 9 a US$ 0,75 per connessione al mese, con un prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Posso inviare un access token TikTok come Authorization: Bearer?
No. Gli endpoint dell'Accounts API leggono il token dall'header Access-Token, quindi un token inviato come Authorization: Bearer lascia il campo vuoto e la chiamata restituisce 40104, anche se TikTok indica il tipo del token come Bearer.
40104 equivale a un token scaduto?
No. 40104 significa che non è arrivato alcun token; uno scaduto restituisce 40102, mentre uno non valido o errato restituisce 40105.
Gli endpoint dei token TikTok richiedono Access-Token?
No. /tt_user/oauth2/token/ e /tt_user/oauth2/refresh_token/ identificano l'app tramite client_id e client_secret nel body della richiesta.
business_id sostituisce il token?
No. business_id indica a quale account TikTok si riferisce la chiamata, mentre Access-Token porta l'autorizzazione ad agire per conto di quell'account. Ogni chiamata richiede entrambi.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il