Erro 40100 do TikTok: pedidos feitos com demasiada frequência
O erro 40100 do TikTok significa que um limite de taxa impediu o pedido: o TikTok responde com o código 40100 no corpo de uma resposta HTTP 200, por isso o estado sozinho não o revela. A solução é suspender as chamadas ao endpoint, 5 minutos após um limite por minuto ou até às 00:00 UTC após um limite diário, e depois enviar menos pedidos, mas maiores.
O easyCoexistence devolve o código e a mensagem do TikTok ao Claude, ao ChatGPT ou ao seu próprio código, para que a sua IA consiga distinguir um limite de taxa de uma publicação falhada e aguardar antes de tentar de novo.
O código que o TikTok devolve quando um limite de taxa é atingido, ou seja, o pedido foi limitado.
O estado que o TikTok envia com os seus códigos de retorno, incluindo o 40100; só o código 0 no corpo indica sucesso.
O limite de taxa da API de Contas para cada conta TikTok autorizada, em cada endpoint.
Todos os endpoints da API de Contas em conjunto, por aplicação de programador no nível Basic; os níveis superiores permitem 1,000.
Quanto tempo o TikTok indica esperar antes de voltar a chamar após atingir um limite por minuto.
O número máximo de publicações de vídeo que uma conta pode publicar pela API num dia, com seis por minuto no máximo.
O que significa o erro 40100?
Um limite de taxa travou o pedido. O anexo de códigos de retorno do TikTok descreve o 40100 como pedidos feitos com demasiada frequência, porque foi atingido o limite do endpoint ao nível da aplicação de programador, e o guia de limites de taxa diz que o servidor devolve o 40100 assim que um limite é atingido. As chamadas a esse endpoint têm de ficar em pausa até que a suspensão seja levantada.
Como detetar o 40100 no código?
Pelo código no corpo da resposta, não pelo estado HTTP. O TikTok envia os seus códigos de retorno com HTTP 200, por isso verifique o campo code em cada resposta: 0 significa sucesso e 40100 um pedido limitado. Um estado 4xx indica um caminho ou método errado, e num 5xx o TikTok aconselha a aguardar cerca de 5 minutos antes de repetir:
// 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 };
}Que limites podem devolver o 40100?
O guia de limites de taxa do TikTok diz que o servidor devolve o 40100 assim que um limite de taxa é atingido, e cada limite é contado em separado, com os valores completos por nível de aplicação na página de limites de taxa. Uma chamada da API de Contas conta para três:
- 40 consultas por minuto para cada conta autorizada em cada endpoint da API de Contas, igual em todos os níveis de aplicação.
- 600 consultas por minuto na API de Contas por aplicação de programador no nível Basic, e 1,000 acima disso.
- Limites de endpoint por aplicação, por segundo, minuto e dia, definidos pelo nível da aplicação.
Quanto tempo deve esperar?
Depende do limite atingido. Após um limite por minuto, o TikTok diz para aguardar 5 minutos antes de voltar a chamar. Após um limite diário, aguarde até ao dia seguinte, pois os limites diários são repostos às 00:00:00 UTC. O guia do TikTok acrescenta que os limites específicos de cada endpoint são independentes, pelo que atingir o limite de um endpoint não impede as chamadas a outro.
O limite de 15 publicações por dia é o mesmo limite?
Não. O teto de publicação conta publicações, seis por minuto e 15 por dia por conta em cada endpoint de publicação, e uma publicação que o ultrapasse falha no seu estado de publicação com spam_risk_too_many_posts e não com 40100. O conselho do TikTok para essa falha é publicar a partir da aplicação móvel do TikTok, e a página de limites de publicações explica-o.
Como ficar abaixo dos limites?
O conselho do TikTok é fazer menos pedidos, mas maiores, e limitar quantos correm ao mesmo tempo. Na API de Contas isso significa ler até 20 publicações por página em /business/video/list/ e até 30 comentários por página em /business/comment/list/, em vez de os obter um a um, espaçar as chamadas com um token bucket, ou pô-las em fila para que um número fixo de workers as envie e as tarefas falhadas voltem à fila após um atraso.
Um nível de aplicação superior trava o 40100?
Só quando o limite atingido foi um limite da aplicação. Cada aplicação começa no nível Basic, e o TikTok sobe-a um nível de cada vez, de Basic para Advanced, depois Premium e Ultimate, mediante um pedido feito em My Apps, App Detail, Authorization que indique um motivo. O guia da API de Contas do TikTok indica o limite de 40 por minuto por conta e endpoint como um valor único, separado do nível da aplicação, por isso uma conta muito ativa resolve-se espaçando as suas chamadas.
Erros comuns
- Voltar a tentar de imediato. O endpoint continua limitado até que a suspensão seja levantada, por isso as tentativas rápidas gastam chamadas sem conseguir passar.
- Obter publicações ou comentários um a um. Uma chamada de listagem devolve uma página de até 20 publicações ou 30 comentários, e cada chamada conta para as 40 por minuto.
- Consultar o estado de publicação em ciclo contínuo. Cada verificação é uma chamada a /business/publish/status/, e os IDs das publicações podem demorar até três minutos a aparecer, por isso espace as verificações.
- Tratar spam_risk_too_many_posts como um limite de taxa. Conta as publicações criadas através da API nas últimas 24 horas, não as chamadas por minuto, por isso abrandar as chamadas não resolve o problema.
As suas ferramentas leem comentários 30 por página e publicações até 20 de cada vez, e publish_tiktok_post avisa a IA logo à partida de que o TikTok limita a publicação pela API a cerca de 15 publicações por dia por conta. De US$ 9 a US$ 0.75 por número ligado por mês, descendo à medida que adiciona números, com os primeiros 3 dias grátis.
Perguntas frequentes
O TikTok devolve HTTP 429 quando uma chamada é limitada?
Os guias do TikTok descrevem uma chamada limitada como o código 40100 no corpo de uma resposta HTTP 200, e não referem nenhum estado 429, por isso verifique o campo code em cada resposta.
Quanto dura uma limitação 40100 do TikTok?
O TikTok diz para aguardar 5 minutos após atingir um limite por minuto. Um limite diário levanta-se às 00:00:00 UTC, altura em que é reposto.
O easyCoexistence volta a tentar uma chamada que devolva 40100?
Não por si só. Uma chamada de ferramenta limitada volta à sua IA com o código 40100 e a mensagem do TikTok, e uma publicação limitada na fila falha com essa mensagem e fica em Requer atenção até escolher Repetir.
O 40100 é diferente do 40016?
O anexo do TikTok dá a ambos a mesma descrição, pedidos feitos com demasiada frequência ao nível da aplicação de programador, e a mesma solução: consulte o guia de limites de taxa. O 40133 cobre o nível do anunciante.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em