Errore TikTok 40102: token di accesso scaduto
L'errore TikTok 40102 significa che il token di accesso inviato con la richiesta è scaduto, e l'endpoint va chiamato con il token più recente. Un token di accesso dell'Accounts API dura un giorno. Per rinnovarlo, invia il refresh token a /tt_user/oauth2/refresh_token/, poi ripeti la chiamata. Il refresh token stesso dura un anno, dopodiché il titolare dell'account autorizza di nuovo l'app.
easyCoexistence rinnova da sé il token TikTok di 24 ore con il refresh token, in anticipo rispetto alla scadenza, così le chiamate da Claude, ChatGPT o dal tuo codice partono con un token aggiornato.
Il codice di ritorno di TikTok per un token di accesso scaduto; l'endpoint va chiamato con quello più recente.
Per quanto tempo un token di accesso dell'account TikTok dell'Accounts API resta valido.
Il valore expires_in, in secondi, nell'esempio TikTok di un token di accesso appena emesso.
Per quanto tempo resta valido il refresh token; alla sua scadenza il titolare deve autorizzare di nuovo l'app.
Cosa significa l'errore 40102?
Il token di accesso nell'header Access-Token ha superato la scadenza. L'appendice dei codici di ritorno di TikTok elenca 40102 come token di accesso scaduto e indica che l'endpoint va chiamato con quello più recente. La soluzione è usare un token di accesso valido e riprovare.
Il codice arriva nel corpo della risposta. La maggior parte delle chiamate all'API for Business di TikTok restituisce HTTP 200, e il codice di ritorno, non lo stato, dice se la chiamata è riuscita.
Per quanto tempo dura un token di accesso TikTok?
Un giorno sull'API for Business. L'Accounts API emette un token di accesso dell'account TikTok quando l'app scambia un codice di autorizzazione su /tt_user/oauth2/token/, e la risposta ne indica la durata in expires_in, 86.400 secondi nell'esempio di TikTok. La stessa risposta contiene un refresh token, valido per un anno, che TikTok consiglia di conservare per rinnovare il token di accesso. I token di accesso utente di TikTok for Developers, usati dalla Content Posting API, durano invece 2 ore.
Come lo si rinnova?
Invia il refresh token a /tt_user/oauth2/refresh_token/ con l'ID e il secret dell'app e grant_type impostato su refresh_token. La risposta contiene un nuovo token di accesso e un nuovo refresh token: salvali entrambi, invia da quel momento il nuovo token di accesso nell'header Access-Token e ripeti la chiamata fallita. Rinnovare prima che la giornata finisca evita che le chiamate arrivino a TikTok con un token scaduto.
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_inQuando il titolare deve autorizzare di nuovo?
Quando il rinnovo non è più possibile. Il refresh token è valido per un anno, e la documentazione di TikTok dice che, una volta scaduto, lo sviluppatore chiede al titolare dell'account di autorizzare di nuovo l'app tramite il flusso di autorizzazione. Il titolare può anche revocare l'autorizzazione in qualsiasi momento dall'app TikTok, sotto Impostazioni e privacy, Sicurezza, Gestisci autorizzazioni app, e una nuova autorizzazione è la via per tornare operativi.
Errori comuni
- Rinnovare solo dopo che una chiamata fallisce. Un token che dura un giorno scade ogni giorno, quindi rinnovalo in anticipo e impedisci che le chiamate arrivino a TikTok con uno vecchio.
- Ignorare il refresh token nella risposta di rinnovo. Il riferimento di TikTok dice di conservarlo per il rinnovo successivo, quindi salva quello che ogni rinnovo restituisce.
- Controllare solo lo stato HTTP. TikTok di solito risponde con HTTP 200 e mette 40102 nel campo code, quindi un controllo sul solo stato legge il fallimento come un successo.
- Tenere copie del token in più punti. Rinnovarne una lascia le altre arrivare alla fine della giornata e fallire con 40102.
Se TikTok rifiuta comunque il token con 40102, 40104 o 40105, la connessione viene subito segnalata per la riconnessione e ricevi un'email. Il tuo codice può ottenere il token corrente da get_social_credentials invece di conservarne una copia. Da US$ 9 a US$ 0.75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e 3 giorni di prova gratuita.
Domande frequenti
Cosa significa expires_in nella risposta di un token TikTok?
È il numero di secondi prima che il token di accesso scada: 86.400, cioè un giorno, nell'esempio di TikTok per un nuovo token dell'Accounts API. Sommalo all'orario della risposta per sapere quando rinnovare, prima del 40102.
Un token di accesso TikTok scaduto si può rinnovare?
Sì, finché il refresh token è valido. Invialo a /tt_user/oauth2/refresh_token/, e TikTok restituisce un nuovo token di accesso con un refresh token.
L'errore 40102 significa che l'account va ricollegato?
Non di per sé. Un refresh token valido rinnova l'accesso senza il titolare; una nuova autorizzazione serve solo quando il refresh token è scaduto o il titolare ha revocato l'accesso.
Perché una risposta con HTTP 200 contiene l'errore 40102?
I codici di ritorno di TikTok hanno la precedenza sullo stato HTTP. Una chiamata risulta riuscita solo se il suo codice è 0, qualunque cosa dica la riga di stato.
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