Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Erreur TikTok 40102 : access token expiré

L'erreur TikTok 40102 signifie que l'access token envoyé avec la requête a expiré : il faut appeler l'endpoint avec le dernier token. Un access token de l'Accounts API dure un jour. Renouvelez-le en envoyant le refresh token à /tt_user/oauth2/refresh_token/, puis répétez l'appel. Le refresh token lui-même dure un an ; ensuite, le propriétaire du compte doit autoriser de nouveau l'application.

easyCoexistence renouvelle seul le token TikTok de 24 heures avec le refresh token, à l'avance, pour que les appels de Claude, ChatGPT ou de votre propre code partent avec un token à jour.

40102

Le code de retour de TikTok pour un access token expiré ; l'endpoint doit être appelé avec le dernier.

1 day

Durée de validité d'un access token de compte TikTok émis par l'Accounts API.

86,400

La valeur expires_in, en secondes, dans l'exemple TikTok d'un access token nouvellement émis.

1 year

Durée de validité du refresh token ; une fois expiré, le propriétaire doit autoriser de nouveau l'application.

Que signifie l'erreur 40102 ?

L'access token présent dans l'en-tête Access-Token a dépassé sa date d'expiration. L'annexe des codes de retour de TikTok classe 40102 comme access token expiré et indique que l'endpoint doit être appelé avec le dernier. La solution consiste à utiliser un access token valide, puis à réessayer.

Le code figure dans le corps de la réponse. La plupart des appels à l'API for Business de TikTok renvoient un HTTP 200 ; c'est le code de retour, et non le statut, qui indique si l'appel a réussi.

Combien de temps dure un access token TikTok ?

Un jour sur l'API for Business. L'Accounts API émet un access token de compte TikTok lorsque l'application échange un code d'autorisation à /tt_user/oauth2/token/ ; la réponse indique sa durée de vie dans expires_in, soit 86 400 secondes dans l'exemple de TikTok. La même réponse contient un refresh token, valable un an, que TikTok demande de conserver pour renouveler l'access token. Les access tokens d'utilisateur de TikTok for Developers, utilisés par la Content Posting API, durent en revanche 2 heures.

Comment le renouveler ?

Envoyez le refresh token à /tt_user/oauth2/refresh_token/ avec l'ID et le secret de l'application, et grant_type à refresh_token. La réponse contient un nouvel access token et un nouveau refresh token : conservez les deux, envoyez désormais le nouvel access token dans l'en-tête Access-Token, puis répétez l'appel qui a échoué. Renouveler avant la fin de la journée évite que les appels atteignent TikTok avec un token expiré.

Renew a TikTok account access token
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_in

Quand le propriétaire doit-il autoriser de nouveau ?

Lorsque le renouvellement n'est plus possible. Le refresh token est valable un an, et la documentation de TikTok indique qu'une fois expiré, le développeur demande au propriétaire du compte d'autoriser de nouveau l'application via le flux d'autorisation. Le propriétaire peut aussi révoquer l'autorisation à tout moment depuis l'application TikTok, dans Paramètres et confidentialité, Sécurité, Gérer les autorisations de l'application ; une nouvelle autorisation permet alors de reprendre.

Erreurs courantes

  • Renouveler seulement après l'échec d'un appel. Un token valable un jour expire chaque jour ; renouvelez-le à l'avance pour éviter que les appels n'atteignent TikTok avec un ancien token.
  • Ignorer le refresh token dans la réponse de renouvellement. La référence de TikTok demande de le conserver pour le renouvellement suivant ; enregistrez donc celui que chaque renouvellement renvoie.
  • Ne vérifier que le statut HTTP. TikTok répond en général avec un HTTP 200 et place 40102 dans le champ code ; une vérification du statut seule compte l'échec comme un succès.
  • Garder des copies du token à plusieurs endroits. Renouveler une copie laisse les autres arriver à la fin de leur journée et échouer avec 40102.
Faire cela avec EasyCoexistence

Si TikTok rejette quand même le token avec 40102, 40104 ou 40105, la connexion passe immédiatement en état de reconnexion et vous recevez un e-mail. Votre code peut récupérer le token actuel via get_social_credentials au lieu de garder une copie. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Que signifie expires_in dans une réponse de token TikTok ?

C'est le nombre de secondes avant l'expiration de l'access token : 86 400, soit un jour, dans l'exemple de TikTok pour un nouveau token de l'Accounts API. Ajoutez cette valeur à l'heure de la réponse pour savoir quand renouveler, avant l'erreur 40102.

Un access token TikTok expiré peut-il être renouvelé ?

Oui, tant que le refresh token est valable. Envoyez-le à /tt_user/oauth2/refresh_token/ : TikTok renvoie un nouvel access token accompagné d'un refresh token.

L'erreur 40102 impose-t-elle de reconnecter le compte ?

Pas en soi. Un refresh token valable renouvelle l'accès sans l'intervention du propriétaire ; une nouvelle autorisation n'est nécessaire que si le refresh token a expiré ou si le propriétaire a révoqué l'accès.

Pourquoi une réponse HTTP 200 contient-elle l'erreur 40102 ?

Les codes de retour de TikTok priment sur le statut HTTP. Un appel n'a réussi que si son code vaut 0, quelle que soit la ligne de statut.

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