Erro 40110 do TikTok: código de autorização inválido
O erro 40110 do TikTok significa que o código de autorização enviado para /tt_user/oauth2/token/ é inválido: ele foi cancelado, já foi usado ou expirou. Um código de autorização da Accounts API dura 10 minutos e funciona apenas uma vez. A correção é um código novo, então envie o titular da conta de volta à URL de autorização e troque o novo código imediatamente.
O easyCoexistence faz a autorização do TikTok para você: você entra com o TikTok pelo painel, e o código é trocado assim que o TikTok o devolve.
Código de retorno do TikTok para um código de autorização cancelado, já usado ou expirado.
Por quanto tempo um código de autorização da Accounts API permanece válido, contra uma hora para um código da Marketing API.
Quantas vezes um código de autorização pode ser trocado por um token de acesso.
URLs de redirecionamento do titular da conta que um app de desenvolvedor pode configurar, com apenas uma ativa por vez.
O que significa o erro 40110?
O TikTok recusou o código de autorização enviado como auth_code para /tt_user/oauth2/token/. O apêndice de códigos de retorno lista três causas: o código foi cancelado, já foi usado ou expirou. Sua mensagem de exemplo diz: "The auth_code is canceled. Please re-authorize and try again with a new auth_code." Qualquer que seja a causa, a correção é a mesma: um código válido.
Por quanto tempo um código de autorização é válido?
Na Accounts API, 10 minutos, e ele só pode ser usado uma vez. O TikTok o adiciona à URL de redirecionamento como parâmetro de consulta quando o titular da conta aprova a autorização, e, depois que expira, as etapas de autorização precisam ser refeitas do início. Códigos da Marketing API duram uma hora, o que vale saber quando um código escrito para essa API é reaproveitado aqui.
Como um código acaba sendo usado duas vezes?
O código trafega na URL de redirecionamento, então qualquer coisa que carregue essa URL novamente ou repita a troca pode tentar gastá-lo uma segunda vez:
- A página de callback é recarregada ou aberta duas vezes pelo navegador, e cada carregamento envia o mesmo código.
- Ao repetir a requisição do token após um timeout, a primeira tentativa pode já ter funcionado.
- Duas partes do app, como o navegador e o servidor, tentam trocar o código.
Como corrigir?
Inicie uma nova autorização. Envie o titular da conta de volta à URL de autorização do TikTok; se ele já aprovou as mesmas permissões antes, o TikTok pula a página de revisão por padrão e redireciona de volta direto com um código novo. Troque-o uma única vez, em até 10 minutos, no servidor, com redirect_uri definido como a URL de redirecionamento configurada no app, e armazene os tokens que ele retornar.
Erros comuns
- Guardar o código para depois. Ele dura 10 minutos, então troque-o assim que o redirecionamento chegar.
- Repetir a troca com o mesmo código após o 40110. O código continua cancelado, usado ou expirado, e só uma nova autorização gera um que funcione.
- Adicionar parâmetros de consulta à URL de redirecionamento. O TikTok exige uma URL HTTPS estática terminando em /, com os valores que o app precisar transportados no parâmetro state.
- Enviar um redirect_uri diferente do definido no app. O endpoint de token do TikTok exige que os dois sejam iguais.
Se o login não puder ser concluído, iniciá-lo de novo pelo painel gera um código novo, e então Claude, ChatGPT ou seu próprio código passam a trabalhar com a conta conectada. De US$ 9 até US$ 0.75 por conexão por mês, com a faixa caindo conforme você adiciona conexões, e os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Por que o TikTok diz que o auth_code foi cancelado?
É a mensagem de exemplo do TikTok para o 40110: "The auth_code is canceled. Please re-authorize and try again with a new auth_code." O código foi cancelado, já usado ou expirou, e só uma nova autorização gera um que funcione.
Um código de autorização do TikTok pode ser reutilizado?
Não. Cada código pode ser trocado uma vez, e um código já usado é uma das causas que o TikTok lista para o 40110.
O titular da conta precisa aprovar cada permissão de novo?
Não por padrão. O TikTok pula a página de revisão para permissões que o titular já aprovou, a menos que a URL de autorização traga disable_auto_auth=1.
Qual a diferença entre 40110 e 40131?
O 40110 diz respeito somente ao código de autorização. O 40131 é um erro de autenticação mais amplo nos endpoints de token, cujas causas incluem um código expirado, além de um App ID ou secret incorreto.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em