AccediInizia la prova gratuita
easyCoexistence API ufficiali

Perché una connessione alla TikTok API smette di funzionare e come mantenerla attiva

Una connessione TikTok API for Business smette di funzionare quando il suo access token di 24 ore non viene rinnovato, il suo refresh token di un anno scade, il titolare dell'account rimuove l'accesso dell'app oppure il token inviato manca o è errato. TikTok segnala i casi legati ai token con i codici 40102, 40103, 40104 e 40105. Rinnovare in anticipo, controllare ogni account secondo una pianificazione e chiedere al titolare di autorizzare di nuovo prima della fine dell'anno la mantengono attiva.

easyCoexistence mantiene attiva ogni connessione TikTok da sola: rinnova il token di 24 ore in anticipo, controlla l'account circa ogni 6 ore e, quando TikTok rifiuta il token, segna il canale come Riconnessione necessaria e ti scrive un'email, per Claude, ChatGPT o la tua piattaforma.

24 hours

Durata dell'access token di un account TikTok dalla API for Business; /tt_user/oauth2/refresh_token/ lo rinnova.

1 year

Durata del refresh token; una volta scaduto, il titolare dell'account deve autorizzare di nuovo l'app.

auth_removed

Motivo di errore quando il titolare rimuove l'accesso dell'app mentre TikTok sta elaborando un post; TikTok indica di non riprovare.

comment.update

Eventi che TikTok smette di inviare per un account quando l'autorizzazione del titolare scade o viene revocata.

5 reasons

Perché scatta authorization.removed di TikTok for Developers: l'utente si disconnette, l'account viene eliminato, cambia l'età, c'è un ban oppure lo sviluppatore revoca l'accesso.

6 hours

Ogni quanto easyCoexistence controlla ogni account TikTok collegato; rinnova da solo il token di 24 ore e ti scrive un'email se serve riconnettere.

Perché una connessione alla TikTok API smette di funzionare?

Per alcuni motivi, la maggior parte legati ai token dell'account o al consenso del titolare. Alcuni interrompono la connessione del tutto, altri la lasciano a metà, con alcune chiamate rifiutate e le altre che rispondono ancora:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

Quale errore restituisce ogni causa e cosa la risolve?

Il campo code di TikTok ne indica la maggior parte, all'interno di una risposta HTTP 200 e non di uno stato di errore, mentre lo stato di pubblicazione aggiunge un motivo di errore proprio. 40100 è nella tabella perché una chiamata limitata può sembrare una connessione persa. Cosa significa ciascuno e come si risolve:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause the endpoint 5 minutes; the token still works

Quanto durano i token e quando conviene rinnovarli?

Nella API for Business, l'access token dura 24 ore e expires_in in ogni risposta indica i secondi rimanenti; il refresh token dura un anno, con un proprio conto alla rovescia in refresh_token_expires_in. Rinnova ben prima che il giorno finisca, secondo una pianificazione e non dopo una chiamata fallita, e conserva il refresh token restituito a ogni rinnovo, perché la nota di TikTok su quel campo indica di mantenerlo. Tratta refresh_token_expires_in come una scadenza: nell'esempio di rinnovo di TikTok il valore scende invece di aprire un nuovo anno.

Cosa succede quando il titolare rimuove l'accesso dell'app?

L'app perde i permessi dell'Accounts API concessi dal titolare, quindi le chiamate con quel token smettono di funzionare, e TikTok non documenta alcun evento della API for Business che lo annunci. Il titolare può farlo in qualsiasi momento nell'app TikTok, alla voce Impostazioni e privacy, Sicurezza, Gestisci i permessi delle app, Rimuovi accesso. I segnali compaiono altrove: un post che TikTok stava elaborando fallisce con auth_removed, motivo per cui TikTok indica di non riprovare, e gli eventi comment.update per l'account smettono di arrivare.

Cosa comporta un cambio di tipo di account per la connessione?

TikTok non collega a questo cambio alcun errore di token nella documentazione; cambia ciò che la API restituisce. Dati come unique_video_views, daily_new_followers e audience_activity richiedono l'Advanced Access o un Verified Business Account, come le API Mentions e Business Messaging, e il privacy_level_options di un account privato esclude PUBLIC_TO_EVERYONE. Dal 16 ottobre 2026, is_business_account risulta true solo per i Verified Business Account e has_advanced_access indica l'Advanced Access; leggerli entrambi, sotto user.account.type, mostra un cambiamento prima che una chiamata vi inciampi.

Come individuare una connessione morta prima del cliente?

Con controlli che girano indipendentemente dal fatto che qualcuno pubblichi:

  • Una chiamata leggera per account a intervalli, come /business/get/ con il campo username, che restituisce un errore di token quando il token smette di funzionare.
  • /tt_user/token_info/get/, che non richiede permessi e restituisce lo scope del token, per confermare che i permessi concessi coprano ancora ciò che le funzioni chiamano.
  • refresh_token_expires_in trasformato in una data a ogni risposta, con un promemoria al titolare alcune settimane prima.
  • Silenzio su comment.update per un account che di solito riceve commenti, perché TikTok interrompe questi eventi quando l'autorizzazione scade o viene revocata.
  • 40102, 40103, 40104 e 40105 conteggiati per account, così un singolo account in errore spicca tra molti.

Come riconnettere un account?

Eseguendo di nuovo l'autorizzazione per lo stesso account. Condividi l'URL di autorizzazione del titolare dell'account TikTok, con un valore state che collega il ritorno all'account, e disable_auto_auth=1 se il titolare deve rivedere la pagina dei permessi. Scambia il nuovo auth_code presso /tt_user/oauth2/token/ entro i suoi 10 minuti, poi sostituisci entrambi i token salvati. open_id è l'ID specifico dell'applicazione che TikTok assegna all'account, quindi abbina i nuovi token al record salvato tramite questo campo invece di crearne un secondo.

Anche le connessioni alla Content Posting API scadono allo stesso modo?

No. TikTok for Developers, che offre le API Content Posting e Display, ha aggiornato le proprie pagine sui token il 2 novembre 2026: gli access token utente scadono entro 2 ore e i refresh token durano 180 giorni dalla prima emissione. I suoi refresh token ruotano, quindi ogni rinnovo riuscito restituisce un nuovo token e invalida subito quello inviato, e se un server continua a usare un token sostituito, i rinnovi successivi falliscono e l'utente deve autorizzare di nuovo. Un refresh token non valido fallisce con invalid_grant, un access token non valido con access_token_invalid e HTTP 401, e il suo webhook authorization.removed spiega perché un utente è uscito.

Cosa fa easyCoexistence per mantenere attiva una connessione TikTok?

Rinnova e controlla da sola, e ti avvisa quando solo il titolare può risolvere:

  • Rinnovo: prima di una chiamata quando restano meno di 15 minuti, e durante un controllo quando restano meno di 8 ore, salvando ogni volta il nuovo refresh token e la sua scadenza.
  • Un solo rinnovo alla volta per account, così le chiamate che arrivano insieme lo condividono.
  • Il controllo: una chiamata /business/get/ per lo username dell'account circa ogni 6 ore.
  • Un token rifiutato, 40102, 40104 o 40105: il canale mostra Riconnessione necessaria, il titolare riceve una sola email e una piattaforma riceve channel.disconnected, con il messaggio di TikTok come disconnected_reason.
  • Fino ad allora, gli strumenti rispondono che l'account deve essere riconnesso, e un post programmato fallisce con motivo reconnect invece di raggiungere TikTok.
  • Riconnessione: connetti TikTok dalla pagina del canale o con una nuova sessione di connessione. Accedendo di nuovo, restano lo stesso account_id e la stessa destinazione degli eventi.

Come configurarlo

  1. 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.
  2. 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.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. 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.
  5. Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.

Errori comuni

  • Considerare un webhook di commento silenzioso come un account silenzioso. TikTok interrompe comment.update per un account quando la sua autorizzazione finisce, quindi controlla l'account invece di aspettare eventi.
  • Riconnettere creando un nuovo record. Abbina i nuovi token tramite open_id, l'ID specifico dell'applicazione che TikTok assegna all'account, e aggiorna il record salvato sul posto, conservando storico e impostazioni.
  • Riprovare 40103 o 40107 con lo stesso refresh token. Nessuno dei due si risolve riprovando: il primo richiede una nuova autorizzazione, il secondo il refresh token dell'ultima risposta oppure una nuova autorizzazione.
  • Leggere 40100 come una connessione persa. È una chiamata limitata: sospendi l'endpoint per 5 minuti, oppure fino alle 00:00 UTC dopo un limite giornaliero, e lo stesso token continua a funzionare.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0.75 per connessione al mese, con un prezzo che scende man mano che aggiungi connessioni, e una prova gratuita di 3 giorni.

Domande frequenti

Una connessione alla TikTok API può durare per sempre senza il titolare?

No. Il rinnovo la mantiene al massimo per l'anno di vita del refresh token; dopo, il percorso documentato da TikTok è una nuova autorizzazione da parte del titolare dell'account.

Perché le connessioni TikTok sono fallite per più account insieme?

Controlla prima l'app, poi gli account: 40113 indica che l'app è bloccata oppure che il suo ID e il suo secret non corrispondono, e TikTok può revocare l'accesso dell'app alla Accounts API in caso di abuso.

Una nuova funzionalità richiede di riconnettere gli account TikTok?

Sì, quando richiede uno scope che il titolare non ha mai concesso. Un token mantiene gli scope approvati al momento dell'autorizzazione, quindi il titolare deve autorizzare di nuovo l'app per aggiungerne uno.

Cosa succede ai post TikTok programmati mentre un account deve essere riconnesso?

Su easyCoexistence, all'orario previsto falliscono con motivo reconnect invece di raggiungere TikTok, il titolare riceve un'email e Riprova li invia una volta che l'account è di nuovo connesso.

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