Errore TikTok 40103: refresh token scaduto
L'errore 40103 di TikTok indica che il refresh token è scaduto, quindi non può più rinnovare il token di accesso dell'account. Un refresh token dell'Accounts API è valido per un anno. La soluzione indicata da TikTok è una nuova autorizzazione: il titolare dell'account ripete il flusso di autorizzazione dell'app, che restituisce una nuova coppia di token da salvare al posto della precedente.
easyCoexistence salva il refresh token e la sua scadenza da ogni rinnovo TikTok e rinnova da solo il token di accesso da 24 ore, per Claude, ChatGPT o il tuo codice.
Il codice di restituzione di TikTok per un refresh token scaduto; la soluzione è che l'utente autorizzi di nuovo l'app.
Per quanto tempo un refresh token dell'Accounts API resta valido.
Secondi in refresh_token_expires_in, esattamente un anno, nell'esempio TikTok dei token appena emessi.
Per quanto tempo il codice di autorizzazione di una nuova autorizzazione resta valido, per un solo utilizzo.
Cosa significa l'errore 40103?
Il refresh token inviato per rinnovare il token di accesso è oltre la scadenza. L'appendice dei codici di restituzione di TikTok elenca 40103 come refresh token scaduto. Per risolvere, serve un refresh token valido, quindi bisogna chiedere all'utente di autorizzare di nuovo l'app tramite il flusso di autorizzazione utente. Finché non succede, il token di accesso non può essere rinnovato, e le chiamate smettono di funzionare quando il token attuale raggiunge la fine del suo periodo di 24 ore.
Quanto dura un refresh token?
Un anno. La risposta di /tt_user/oauth2/token/ include refresh_token_expires_in, i secondi che restano prima della scadenza del refresh token: 31.536.000 nell'esempio TikTok, esattamente un anno. Anche le risposte di rinnovo contengono lo stesso campo, e l'esempio di rinnovo di TikTok mostra 28.484.364 secondi, meno di un anno. Quindi va letto il valore di ogni risposta, senza presumere che ogni rinnovo apra un nuovo anno.
Come si risolve?
Chiedi al titolare dell'account di autorizzare di nuovo l'app. Condividi l'URL di autorizzazione del titolare dell'account TikTok; quando approva, TikTok reindirizza all'URL di reindirizzamento dell'app con un nuovo auth_code, valido per 10 minuti e utilizzabile una sola volta. Scambialo su /tt_user/oauth2/token/ per un nuovo token di accesso e un nuovo refresh token, e sostituisci la coppia salvata. Se il titolare aveva già approvato gli stessi permessi, TikTok di default salta la pagina di revisione e lo rimanda subito indietro.
In cosa 40103 differisce da 40107 e 40131?
L'appendice contiene tre codici per un rinnovo fallito, che rimandano a controlli diversi:
- 40103: il refresh token è scaduto. Solo una nuova autorizzazione lo sostituisce.
- 40107: il refresh token non è valido o è errato, ad esempio quello inviato per rinnovare un token della Marketing API, che non scade mai.
- 40131: errore di autenticazione su /
tt_user/oauth2/token/ o /tt_user/oauth2/refresh_token/, dovuto a un app ID o un secret errati, a un codice di autorizzazione scaduto, oppure a un refresh token non valido o scaduto.
Errori comuni
- Aspettare 40103 per pianificare la prossima autorizzazione. refresh_token_expires_in indica la data in anticipo, così il titolare può essere contattato prima che il rinnovo si interrompa.
- Presumere che ogni rinnovo faccia ripartire l'anno. L'esempio di rinnovo di TikTok restituisce in refresh_token_expires_in meno di un anno, quindi va letto il valore da ogni risposta.
- Scartare il refresh token restituito da un rinnovo. Il riferimento di TikTok dice di conservarlo per il rinnovo successivo.
Se TikTok rifiuta un rinnovo, lo strumento restituisce il codice e il messaggio di TikTok, e ricollegare l'account dalla dashboard emette una nuova coppia di token. Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.
Domande frequenti
Anche i refresh token della Content Posting API durano un anno?
No. I refresh token di TikTok for Developers, usati dalla Content Posting API, durano 180 giorni; la durata di un anno vale per i refresh token di API for Business, i cui secondi residui compaiono in refresh_token_expires_in.
Un refresh token TikTok scaduto può essere rinnovato?
No. La soluzione di TikTok per 40103 è una nuova autorizzazione da parte del titolare dell'account, che emette un nuovo token di accesso e un nuovo refresh token.
Il titolare vede di nuovo la pagina dei permessi di TikTok?
Non di default. Se aveva già approvato gli stessi permessi, TikTok salta la pagina di revisione e reindirizza all'app con un nuovo codice di autorizzazione.
Cosa succede alle chiamate dopo la scadenza del refresh token?
Continuano a funzionare fino alla fine del periodo di 24 ore del token di accesso attuale. Dopo, falliscono con 40102, perché il token non può più essere rinnovato.
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