Erreur TikTok 40103 : refresh token expiré
L'erreur TikTok 40103 signifie que le refresh token a expiré : il ne peut donc plus renouveler l'access token du compte. Un refresh token de l'API Accounts est valable un an. La solution proposée par TikTok est une nouvelle autorisation : le titulaire du compte repasse par le parcours d'autorisation de l'application, ce qui renvoie un nouvel access token et un nouveau refresh token à stocker à la place de l'ancienne paire.
easyCoexistence stocke le refresh token et sa date d'expiration à chaque renouvellement TikTok, et renouvelle seul l'access token de 24 heures, pour Claude, ChatGPT ou votre propre code.
Le code de retour de TikTok pour un refresh token expiré ; la solution est que l'utilisateur autorise de nouveau l'application.
Durée de validité d'un refresh token de l'API Accounts.
Secondes dans refresh_token_expires_in, soit exactement un an, dans l'exemple TikTok de tokens nouvellement émis.
Durée de validité du code d'autorisation issu d'une nouvelle autorisation, utilisable une seule fois.
Que signifie l'erreur 40103 ?
Le refresh token envoyé pour renouveler l'access token a dépassé sa date d'expiration. L'annexe des codes de retour de TikTok classe 40103 comme refresh token expiré. Pour y remédier, il faut un refresh token valide, et donc demander à l'utilisateur d'autoriser de nouveau l'application via le parcours d'autorisation utilisateur. Tant que ce n'est pas fait, l'access token ne peut pas être renouvelé, et les appels cessent de fonctionner à la fin de la journée en cours, lorsque le token actuel arrive à échéance.
Combien de temps un refresh token est-il valable ?
Un an. La réponse de /tt_user/oauth2/token/ inclut refresh_token_expires_in, le nombre de secondes restantes avant l'expiration du refresh token : 31 536 000 dans l'exemple de TikTok, soit exactement un an. Les réponses de renouvellement contiennent le même champ, et l'exemple de renouvellement de TikTok affiche 28 484 364 secondes, soit moins d'un an. Il faut donc lire la valeur dans chaque réponse plutôt que supposer que chaque renouvellement ouvre une nouvelle année.
Comment corriger le problème ?
Demandez au titulaire du compte d'autoriser de nouveau l'application. Partagez l'URL d'autorisation du titulaire du compte TikTok ; une fois qu'il a approuvé, TikTok redirige vers l'URL de redirection de l'application avec un nouveau auth_code, valable 10 minutes et utilisable une seule fois. Échangez-le sur /tt_user/oauth2/token/ contre un nouvel access token et un nouveau refresh token, puis remplacez la paire stockée. Si le titulaire avait déjà approuvé les mêmes permissions, TikTok passe par défaut la page de validation et le renvoie directement.
En quoi 40103 diffère-t-il de 40107 et 40131 ?
L'annexe recense trois codes pour un renouvellement en échec, qui renvoient à des contrôles différents :
- 40103 : le refresh token a expiré. Seule une nouvelle autorisation le remplace.
- 40107 : le refresh token est invalide ou incorrect, par exemple envoyé pour renouveler un token de l'API Marketing, qui n'expire jamais.
- 40131 : une erreur d'authentification sur /
tt_user/oauth2/token/ ou /tt_user/oauth2/refresh_token/, due à un mauvais app ID ou secret de l'application, à un code d'autorisation expiré, ou à un refresh token invalide ou expiré.
Erreurs courantes
- Attendre le code 40103 pour planifier la prochaine autorisation. refresh_token_expires_in donne la date à l'avance, ce qui permet de demander l'autorisation avant l'arrêt des renouvellements.
- Supposer que chaque renouvellement relance l'année. L'exemple de renouvellement de TikTok renvoie moins d'un an dans refresh_token_expires_in : il faut lire la valeur de chaque réponse.
- Jeter le refresh token retourné par un renouvellement. La référence de TikTok indique de le conserver pour le renouvellement suivant.
Si TikTok refuse un renouvellement, l'outil renvoie le code et le message de TikTok ; reconnecter le compte depuis le tableau de bord délivre une nouvelle paire de tokens. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.
Questions fréquemment posées
Les refresh tokens de l'API Content Posting ont-ils aussi une durée d'un an ?
Non. Les refresh tokens de TikTok for Developers, utilisés par l'API Content Posting, durent 180 jours ; la durée d'un an concerne les refresh tokens de l'API for Business, dont le nombre de secondes restantes figure dans refresh_token_expires_in.
Un refresh token TikTok expiré peut-il être renouvelé ?
Non. La solution de TikTok pour 40103 est une nouvelle autorisation par le titulaire du compte, qui délivre un nouvel access token et un nouveau refresh token.
Le titulaire voit-il de nouveau la page des permissions de TikTok ?
Pas par défaut. S'il avait déjà approuvé les mêmes permissions, TikTok passe la page de validation et le renvoie vers l'application avec un nouveau code d'autorisation.
Que se passe-t-il pour les appels après l'expiration du refresh token ?
Ils continuent de fonctionner jusqu'à la fin de la journée de validité de l'access token en cours. Ensuite ils échouent avec 40102, car le token ne peut plus être renouvelé.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le