Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Erreur TikTok 40100 : requêtes envoyées trop fréquemment

L'erreur TikTok 40100 signifie qu'une limite de débit a bridé la requête : TikTok renvoie le code 40100 dans le corps d'une réponse HTTP 200, si bien que le statut seul ne le révèle pas. La solution consiste à suspendre les appels vers cet endpoint, 5 minutes après une limite par minute ou jusqu'à 00:00 UTC après une limite quotidienne, puis à envoyer moins de requêtes, mais plus volumineuses.

easyCoexistence transmet à Claude, ChatGPT ou à votre propre code le code et le message de TikTok, afin que votre IA distingue une limite de débit d'une publication échouée et attende avant de réessayer.

40100

Le code renvoyé par TikTok une fois une limite de débit atteinte, signifiant que la requête a été bridée.

HTTP 200

Le statut que TikTok envoie avec ses codes de retour, dont 40100 ; seul le code 0 dans le corps indique un succès.

40 QPM

La limite de débit de l'Accounts API pour chaque compte TikTok autorisé, sur chaque endpoint.

600 QPM

L'ensemble des endpoints de l'Accounts API combinés, par application développeur au niveau Basic ; les niveaux supérieurs autorisent 1 000.

5 minutes

Le délai que TikTok indique d'attendre avant de rappeler après avoir atteint une limite par minute.

15 a day

Le nombre maximal de publications vidéo qu'un compte peut publier par jour via l'API, à six par minute au plus.

Que signifie l'erreur 40100 ?

Une limite de débit a interrompu la requête. L'annexe des codes de retour de TikTok décrit 40100 comme des requêtes envoyées trop fréquemment, car la limite de l'endpoint au niveau de l'application développeur a été atteinte, et son guide des limites de débit indique que le serveur renvoie 40100 dès qu'une limite est atteinte. Les appels vers cet endpoint doivent être suspendus jusqu'à ce que la suspension soit levée.

Comment détecter 40100 dans le code ?

Par le code présent dans le corps de la réponse, et non par le statut HTTP. TikTok envoie ses codes de retour avec un HTTP 200 : vérifiez donc code à chaque réponse, 0 signifiant un succès et 40100 une requête bridée. Un statut 4xx indique un chemin ou une méthode incorrects, et sur un 5xx TikTok conseille d'attendre environ 5 minutes avant de réessayer :

Reading TikTok's answer in Node.js
// TikTok returns its error codes with HTTP 200: read code, not only the status.
async function callTikTok(url, accessToken) {
  const res = await fetch(url, { headers: { "Access-Token": accessToken } });
  if (res.status >= 500) return { retryInMs: 5 * 60_000 }; // TikTok: wait about 5 minutes
  if (!res.ok) throw new Error("HTTP " + res.status + ": check the path and the method");
  const body = await res.json();
  if (body.code === 40100) return { retryInMs: 5 * 60_000 }; // throttled: pause this endpoint
  if (body.code !== 0) throw new Error("TikTok " + body.code + ": " + body.message);
  return { data: body.data };
}

Quelles limites peuvent renvoyer 40100 ?

Le guide des limites de débit de TikTok indique que le serveur renvoie 40100 dès qu'une limite de débit est atteinte, chacune étant comptée séparément, avec les chiffres complets par niveau d'application sur la page des limites de débit. Un appel à l'Accounts API est comptabilisé dans trois limites :

  • 40 requêtes par minute pour chaque compte autorisé sur chaque endpoint de l'Accounts API, identique à tous les niveaux d'application.
  • 600 requêtes par minute pour l'ensemble de l'Accounts API par application développeur au niveau Basic, et 1 000 au-delà.
  • Des limites par endpoint et par application, en secondes, minutes et jours, fixées selon le niveau de l'application.

Combien de temps faut-il attendre ?

Cela dépend de la limite atteinte. Après une limite par minute, TikTok demande d'attendre 5 minutes avant de rappeler. Après une limite quotidienne, attendez le lendemain, les limites quotidiennes se réinitialisant à 00:00:00 UTC. Le guide de TikTok précise que les limites propres à chaque endpoint sont indépendantes : atteindre la limite d'un endpoint n'interrompt pas les appels vers un autre.

La limite de 15 publications par jour est-elle la même ?

Non. Le plafond de publication compte les publications, six par minute et 15 par jour et par compte sur chaque endpoint de publication, et une publication au-delà échoue, dans son statut de publication, avec spam_risk_too_many_posts et non avec 40100. Le conseil de TikTok pour cet échec est de publier la vidéo depuis l'application mobile TikTok, et la page des limites de publication le détaille.

Comment rester sous les limites ?

Le conseil de TikTok est d'envoyer moins de requêtes, mais plus volumineuses, et de limiter le nombre de requêtes exécutées simultanément. Sur l'Accounts API, cela signifie lire jusqu'à 20 publications par page de /business/video/list/ et jusqu'à 30 commentaires par page de /business/comment/list/, au lieu de les récupérer un par un, espacer les appels avec un token bucket, ou les mettre en file d'attente afin qu'un nombre fixe de workers les envoie, les tâches échouées revenant dans la file après un délai.

Un niveau d'application supérieur empêche-t-il 40100 ?

Seulement lorsque la limite atteinte est celle de l'application. Chaque application démarre au niveau Basic, et TikTok le relève d'un niveau à la fois, de Basic à Advanced, puis Premium et Ultimate, sur une demande faite sous My Apps, App Detail, Authorization en indiquant un motif. Le guide de l'Accounts API de TikTok indique la limite de 40 par minute et par compte et endpoint comme un chiffre unique, distinct du niveau de l'application : un compte très sollicité se corrige donc en espaçant ses appels.

Erreurs courantes

  • Relancer aussitôt. L'endpoint reste bridé jusqu'à la levée de la suspension : des tentatives rapprochées consomment des appels sans aboutir.
  • Récupérer les publications ou les commentaires un par un. Un appel de liste renvoie une page de 20 publications au plus ou de 30 commentaires, et chaque appel compte dans les 40 par minute.
  • Interroger le statut de publication en boucle serrée. Chaque vérification est un appel à /business/publish/status/, et les identifiants de publication peuvent mettre jusqu'à trois minutes à apparaître : espacez les vérifications.
  • Traiter spam_risk_too_many_posts comme une limite de débit. Il compte les publications créées via l'API sur les 24 dernières heures, et non les appels par minute : ralentir les appels ne le résout donc pas.
Faire cela avec EasyCoexistence

Ses outils lisent les commentaires par pages de 30 et les publications jusqu'à 20 à la fois, et publish_tiktok_post prévient l'IA dès le départ que TikTok plafonne la publication via l'API à environ 15 publications par jour et par compte. À partir de US$ 9 par connexion et par mois, dégressif jusqu'à US$ 0,75 à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.

Questions fréquemment posées

TikTok renvoie-t-il HTTP 429 lorsqu'un appel est bridé ?

Les guides de TikTok décrivent un appel bridé comme le code 40100 dans le corps d'une réponse HTTP 200, sans mentionner de statut 429 : vérifiez donc le champ code de chaque réponse.

Combien de temps dure un blocage TikTok 40100 ?

TikTok demande d'attendre 5 minutes après l'atteinte d'une limite par minute. Une limite quotidienne est levée à 00:00:00 UTC, moment de sa réinitialisation.

easyCoexistence relance-t-il un appel qui renvoie 40100 ?

Pas de lui-même. Un appel d'outil bridé revient à votre IA avec le code 40100 et le message de TikTok, et une publication bridée dans la file échoue avec ce message et attend sous « Needs attention » jusqu'à ce que vous choisissiez « Retry ».

40100 est-il différent de 40016 ?

L'annexe de TikTok donne à ces deux codes la même description, des requêtes envoyées trop fréquemment au niveau de l'application développeur, et la même solution : consulter le guide des limites de débit. 40133 concerne le niveau annonceur.

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