Error 40100 de TikTok: peticiones hechas con demasiada frecuencia
El error 40100 de TikTok significa que un límite de tasa frenó la petición: TikTok responde con el código 40100 en el cuerpo de una respuesta HTTP 200, así que el estado HTTP por sí solo no lo revela. La solución es pausar las llamadas a ese endpoint, 5 minutos después de alcanzar un límite por minuto o hasta las 00:00 UTC si se alcanzó uno diario, y después enviar menos peticiones, pero más grandes.
easyCoexistence devuelve el código y el mensaje de TikTok a Claude, ChatGPT o tu propio código, para que tu IA distinga un límite de tasa de una publicación fallida y espere antes de volver a intentarlo.
El código que TikTok devuelve cuando se alcanza un límite de tasa, lo que significa que la petición fue frenada.
El estado que TikTok envía junto con sus códigos de retorno, incluido el 40100; solo el código 0 en el cuerpo significa éxito.
El límite de tasa de la API de Accounts para cada cuenta autorizada de TikTok en cada endpoint.
Todos los endpoints de la API de Accounts en conjunto, por app de desarrollador en el nivel Basic; los niveles superiores permiten 1000.
El tiempo que TikTok indica esperar antes de volver a llamar tras alcanzar un límite por minuto.
El máximo de publicaciones de video que una cuenta puede hacer a través de la API en un día, con un máximo de seis por minuto.
¿Qué significa el error 40100?
Un límite de tasa detuvo la petición. El apéndice de códigos de retorno de TikTok describe el 40100 como peticiones hechas con demasiada frecuencia, porque se alcanzó el límite del endpoint a nivel de app de desarrollador, y su guía de límites de tasa indica que el servidor devuelve 40100 en cuanto se alcanza un límite. Las llamadas a ese endpoint deben pausarse hasta que se levante la suspensión.
¿Cómo detectar el error 40100 en el código?
Por el código del cuerpo, no por el estado HTTP. TikTok envía sus códigos de retorno con HTTP 200, así que revisa el campo code en cada respuesta: 0 significa éxito y 40100, una petición frenada. Un estado 4xx indica una ruta o un método incorrectos, y ante un 5xx TikTok recomienda esperar unos 5 minutos antes de reintentar:
// 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 };
}¿Qué límites pueden devolver el error 40100?
La guía de límites de tasa de TikTok indica que el servidor devuelve 40100 en cuanto se alcanza un límite de tasa, y cada límite se cuenta por separado; las cifras completas por nivel de app están en la página de límites de tasa. Una llamada a la API de Accounts computa en tres de ellos:
- 40 consultas por minuto para cada cuenta autorizada en cada endpoint de la API de Accounts, igual en todos los niveles de app.
- 600 consultas por minuto en el conjunto de la API de Accounts por app de desarrollador en el nivel Basic, y 1000 en los niveles superiores.
- Límites de la app por endpoint, por segundo, minuto y día, que dependen del nivel de la app.
¿Cuánto tiempo hay que esperar?
Depende del límite alcanzado. Tras un límite por minuto, TikTok indica esperar 5 minutos antes de volver a llamar. Tras un límite diario, hay que esperar al día siguiente, ya que los límites diarios se reinician a las 00:00:00 UTC. La guía de TikTok añade que los límites específicos de cada endpoint son independientes, así que alcanzar el límite de un endpoint no bloquea las llamadas a otro.
¿El tope de 15 publicaciones al día es el mismo límite?
No. El tope de publicación cuenta publicaciones, seis por minuto y 15 al día por cuenta en cada endpoint de publicación, y una publicación que lo supera falla en su estado de publicación con spam_risk_too_many_posts, no con 40100. Para ese fallo, TikTok aconseja publicar el contenido desde la app móvil de TikTok, y la página de límites de publicación lo explica.
¿Cómo no superar los límites?
TikTok aconseja hacer menos peticiones, pero más grandes, y limitar cuántas se ejecutan a la vez. En la API de Accounts, eso significa leer hasta 20 publicaciones por página de /business/video/list/ y hasta 30 comentarios por página de /business/comment/list/ en lugar de pedirlos uno a uno, espaciar las llamadas con un token bucket o ponerlas en una cola para que un número fijo de workers las envíe y las tareas fallidas vuelvan a la cola tras un tiempo de espera.
¿Subir de nivel la app evita el error 40100?
Solo si el límite alcanzado era uno de la app. Toda app empieza en Basic, y TikTok la sube de nivel de uno en uno, de Basic a Advanced y luego a Premium y Ultimate, a partir de una solicitud motivada hecha en My Apps, App Detail, Authorization. La guía de la API de Accounts de TikTok fija el límite de 40 por minuto por cuenta y endpoint como una cifra única, independiente del nivel de la app, así que el caso de una cuenta con mucha actividad se resuelve espaciando sus llamadas.
Errores comunes
- Reintentar de inmediato. El endpoint sigue frenado hasta que se levanta la suspensión, así que los reintentos rápidos gastan llamadas sin conseguir pasar.
- Obtener publicaciones o comentarios uno a uno. Una llamada de lista devuelve una página de hasta 20 publicaciones o 30 comentarios, y cada llamada cuenta para el límite de 40 por minuto.
- Consultar el estado de publicación en un bucle sin pausas. Cada consulta es una llamada a /business/publish/status/, y los IDs de publicación pueden tardar hasta tres minutos en aparecer, así que conviene espaciar las consultas.
- Tratar spam_risk_too_many_posts como un límite de tasa. Cuenta las publicaciones creadas a través de la API en las últimas 24 horas, no las llamadas por minuto, así que reducir el ritmo de las llamadas no lo soluciona.
Sus herramientas leen los comentarios en páginas de 30 y las publicaciones de hasta 20 en 20, y publish_tiktok_post avisa de antemano a la IA de que TikTok limita la publicación a través de la API a unas 15 publicaciones al día por cuenta. De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿TikTok devuelve HTTP 429 cuando una llamada supera el límite de tasa?
Las guías de TikTok describen una llamada frenada como el código 40100 en el cuerpo de una respuesta HTTP 200 y no mencionan ningún estado 429, así que revisa el campo code en cada respuesta.
¿Cuánto dura el bloqueo por el error 40100 de TikTok?
TikTok indica esperar 5 minutos después de alcanzar un límite por minuto. Un límite diario se levanta a las 00:00:00 UTC, cuando se reinicia.
¿easyCoexistence reintenta una llamada que devuelve 40100?
No de forma automática. Una llamada de herramienta frenada vuelve a tu IA con el código 40100 y el mensaje de TikTok, y una publicación frenada en la cola falla con ese mensaje y queda en Needs attention hasta que elijas Retry.
¿El error 40100 es distinto del 40016?
El apéndice de TikTok da a ambos la misma descripción, peticiones hechas con demasiada frecuencia a nivel de app de desarrollador, y la misma solución: consultar la guía de límites de tasa. El 40133 corresponde al nivel de anunciante.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el