Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Pourquoi une connexion à l'API TikTok cesse de fonctionner, et comment la maintenir active

Une connexion TikTok API for Business cesse de fonctionner lorsque son access token de 24 heures n'est pas renouvelé, que son refresh token d'un an arrive à échéance, que le propriétaire retire l'accès de l'application, ou que le token envoyé est absent ou incorrect. TikTok signale les cas liés aux tokens par les codes 40102, 40103, 40104 et 40105. Renouveler à l'avance, vérifier chaque compte selon un calendrier et demander au propriétaire de réautoriser avant la fin de l'année permettent de maintenir la connexion active.

easyCoexistence maintient chaque connexion TikTok active de lui-même : il renouvelle le token de 24 heures à l'avance, vérifie le compte environ toutes les 6 heures, et lorsque TikTok refuse le token, il passe le canal en Reconnexion nécessaire et vous envoie un e-mail, pour Claude, ChatGPT ou votre propre plateforme.

24 hours

Durée de vie de l'access token d'un compte TikTok dans l'API for Business ; /tt_user/oauth2/refresh_token/ le renouvelle.

1 year

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

auth_removed

Motif d'échec lorsque le propriétaire retire l'accès de l'application pendant que TikTok traite une publication ; TikTok indique de ne pas réessayer.

comment.update

Événements que TikTok cesse d'envoyer pour un compte une fois l'autorisation du propriétaire expirée ou révoquée.

5 reasons

Raisons de l'événement authorization.removed de TikTok for Developers : l'utilisateur se déconnecte, le compte est supprimé, l'âge change, un bannissement, ou le développeur révoque l'accès.

6 hours

Fréquence à laquelle easyCoexistence vérifie chaque compte TikTok connecté ; il renouvelle seul le token de 24 heures et vous envoie un e-mail si une reconnexion est nécessaire.

Pourquoi une connexion à l'API TikTok cesse-t-elle de fonctionner ?

Pour quelques raisons, la plupart liées aux tokens du compte ou au consentement du propriétaire. Certaines coupent complètement la connexion, tandis que d'autres la laissent partiellement fonctionnelle, certains appels étant refusés et les autres répondant encore :

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

Quelle erreur renvoie chaque cause, et comment la corriger ?

Le champ code de TikTok désigne la plupart d'entre elles, dans une réponse HTTP 200 plutôt que dans un statut d'erreur, et le statut de publication ajoute un motif d'échec propre. 40100 figure dans le tableau parce qu'un appel limité en débit peut ressembler à une connexion perdue. Signification de chacune et correction :

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

Combien de temps durent les tokens, et quand faut-il les renouveler ?

Dans l'API for Business, l'access token dure 24 heures, et expires_in dans chaque réponse de token indique les secondes restantes ; le refresh token dure un an, avec son propre compte à rebours dans refresh_token_expires_in. Renouvelez bien avant la fin de la journée, selon un calendrier plutôt qu'après un appel en échec, et conservez le refresh token renvoyé à chaque renouvellement, puisque la note de TikTok sur ce champ indique de le conserver. Traitez refresh_token_expires_in comme une échéance : dans l'exemple de renouvellement de TikTok, il décompte au lieu de démarrer une nouvelle année.

Que se passe-t-il lorsque le propriétaire retire l'accès de l'application ?

L'application perd les permissions de l'Accounts API accordées par le propriétaire : les appels avec ce token cessent de fonctionner, et TikTok ne documente aucun événement de l'API for Business qui l'annonce. Le propriétaire peut le faire à tout moment dans l'application TikTok, sous Paramètres et confidentialité, Sécurité, Gérer les autorisations de l'application, Retirer l'accès. Les signes apparaissent ailleurs : une publication que TikTok traitait échoue avec auth_removed, motif pour lequel TikTok indique de ne pas réessayer, et les événements comment.update du compte cessent d'arriver.

Qu'est-ce qu'un changement de type de compte fait à la connexion ?

TikTok ne rattache aucune erreur de token à ce changement dans sa documentation ; ce qui change, c'est ce que l'API renvoie. Des données comme unique_video_views, daily_new_followers et audience_activity nécessitent un accès avancé ou un compte professionnel vérifié, de même que les API Mentions et Business Messaging, et les privacy_level_options d'un compte privé excluent PUBLIC_TO_EVERYONE. Depuis le 16 octobre 2026, is_business_account n'est vrai que pour les comptes professionnels vérifiés et has_advanced_access indique l'accès avancé ; lire les deux, sous user.account.type, révèle donc un changement avant qu'un appel n'échoue.

Comment repérer une connexion morte avant un client ?

Avec des vérifications qui tournent, qu'il y ait ou non des publications :

  • Un appel léger par compte selon un calendrier, comme /business/get/ avec le champ username, qui renvoie une erreur de token une fois le token inopérant.
  • /tt_user/token_info/get/, qui ne nécessite aucune permission et renvoie les scopes du token, pour confirmer que les autorisations couvrent toujours ce qu'appellent vos fonctionnalités.
  • refresh_token_expires_in converti en date à l'arrivée de chaque réponse, avec un rappel au propriétaire quelques semaines avant.
  • Un silence sur comment.update pour un compte qui reçoit d'habitude des commentaires, puisque TikTok arrête ces événements une fois l'autorisation expirée ou révoquée.
  • Les codes 40102, 40103, 40104 et 40105 comptés par compte, pour qu'un compte en échec se distingue parmi beaucoup.

Comment reconnecter un compte ?

En relançant l'autorisation pour le même compte. Partagez l'URL d'autorisation du titulaire du compte TikTok, avec une valeur state qui relie le retour au compte, et disable_auto_auth=1 si le propriétaire doit revoir la page des permissions. Échangez le nouvel auth_code sur /tt_user/oauth2/token/ dans ses 10 minutes, puis remplacez les deux tokens stockés. open_id est l'identifiant propre à l'application que TikTok attribue au compte : faites correspondre les nouveaux tokens à l'enregistrement existant grâce à lui, au lieu d'en créer un second.

Les connexions à l'API Content Posting expirent-elles de la même façon ?

Non. TikTok for Developers, qui sert les API Content Posting et Display, a mis à jour ses pages sur les tokens le 2 novembre 2026 : les access tokens utilisateur expirent dans les 2 heures et les refresh tokens durent 180 jours à compter de leur première émission. Ses refresh tokens tournent : chaque rafraîchissement réussi en renvoie un nouveau et invalide aussitôt celui envoyé ; si un serveur continue d'utiliser un token remplacé, les rafraîchissements suivants échouent et l'utilisateur doit autoriser à nouveau. Un mauvais refresh token échoue avec invalid_grant, un mauvais access token avec access_token_invalid et HTTP 401, et son webhook authorization.removed indique la raison du départ d'un utilisateur.

Que fait easyCoexistence pour maintenir une connexion TikTok active ?

Il renouvelle et vérifie de lui-même, et vous prévient lorsque seul le propriétaire peut corriger la situation :

  • Renouvellement : avant un appel lorsqu'il reste moins de 15 minutes, et lors d'une vérification lorsqu'il reste moins de 8 heures, en stockant à chaque fois le nouveau refresh token et son échéance.
  • Un seul renouvellement à la fois par compte, pour que les appels arrivant ensemble le partagent.
  • La vérification : un appel /business/get/ pour le username du compte environ toutes les 6 heures.
  • Un token refusé, 40102, 40104 ou 40105 : le canal affiche Reconnexion nécessaire, le propriétaire reçoit un seul e-mail, et une plateforme reçoit channel.disconnected, avec le message de TikTok en disconnected_reason.
  • D'ici là, les outils répondent que le compte doit être reconnecté, et une publication programmée échoue avec le statut reconnect au lieu d'atteindre TikTok.
  • Reconnexion : Connecter TikTok sur la page du canal, ou une nouvelle session de connexion, vous reconnecte et conserve le même account_id et la même destination d'événements.

Comment le configurer

  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.

Erreurs courantes

  • Prendre un webhook de commentaires silencieux pour un compte silencieux. TikTok arrête comment.update pour un compte dès que son autorisation prend fin : vérifiez donc le compte au lieu d'attendre des événements.
  • Reconnecter dans un nouvel enregistrement. Faites correspondre les nouveaux tokens par open_id, l'identifiant propre à l'application que TikTok attribue au compte, et mettez à jour l'enregistrement existant, en conservant son historique et ses paramètres.
  • Réessayer 40103 ou 40107 avec le même refresh token. Aucun des deux ne se résout au nouvel essai : le premier exige une nouvelle autorisation, le second le refresh token de la dernière réponse ou une nouvelle autorisation.
  • Prendre 40100 pour une connexion perdue. C'est un appel limité en débit ; mettez l'endpoint en pause 5 minutes, ou jusqu'à 00:00 UTC après une limite quotidienne, et le même token continue de fonctionner.
Faire cela avec EasyCoexistence

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

Une connexion à l'API TikTok peut-elle durer indéfiniment sans le propriétaire ?

Non. Le renouvellement la fait tenir au plus une année de refresh token ; ensuite, la voie documentée par TikTok est une nouvelle autorisation du titulaire du compte.

Pourquoi les connexions TikTok ont-elles échoué pour plusieurs comptes à la fois ?

Vérifiez d'abord l'application avant les comptes : 40113 signifie que l'application est bloquée ou que son identifiant et son secret ne correspondent pas, et TikTok peut révoquer l'accès d'une application à l'Accounts API en cas d'usage abusif.

Une nouvelle fonctionnalité impose-t-elle de reconnecter les comptes TikTok ?

Oui, lorsqu'elle nécessite un scope que le propriétaire n'a jamais accordé. Un token conserve les scopes approuvés lors de l'autorisation ; le propriétaire doit donc autoriser à nouveau l'application pour en ajouter un.

Que deviennent les publications TikTok programmées pendant qu'un compte doit être reconnecté ?

Sur easyCoexistence, elles échouent avec le statut reconnect à leur heure prévue au lieu d'atteindre TikTok, le propriétaire reçoit un e-mail, et Réessayer les envoie dès que le compte est de nouveau connecté.

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