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: foi cancelado, já foi usado ou expirou. Um código de autorização da Accounts API dura 10 minutos e só funciona uma vez. A solução é obter um código novo, por isso encaminhe de novo o titular da conta para o URL de autorização e troque o novo código de imediato.
A easyCoexistence faz por si a autorização do TikTok: inicia-se sessão no TikTok a partir do painel, e o código é trocado assim que o TikTok o reencaminha de volta.
O 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 se mantém 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.
Quantos URLs de redirecionamento do titular da conta pode configurar uma aplicação de programador, com apenas um ativo de cada 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 anexo dos códigos de retorno lista três causas: o código foi cancelado, já foi usado ou expirou. A mensagem de exemplo diz: "The auth_code is canceled. Please re-authorize and try again with a new auth_code." Seja qual for a causa, a soluçã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 só pode ser usado uma vez. O TikTok acrescenta-o ao URL de redirecionamento como parâmetro de consulta quando o titular da conta aprova a autorização, e, depois de expirar, os passos de autorização têm de recomeçar. Os códigos da Marketing API duram uma hora, o que convém saber quando um código escrito para essa API é reutilizado aqui.
Como é que um código é usado duas vezes?
O código viaja no URL de redirecionamento, por isso qualquer coisa que volte a carregar esse URL ou repita a troca pode tentar gastá-lo uma segunda vez:
- A página de retorno é recarregada ou aberta duas vezes pelo navegador, e cada carregamento envia o mesmo código.
- Uma nova tentativa repete o pedido de token após um tempo limite, embora a primeira tentativa possa já ter tido êxito.
- Duas partes da aplicação, como o navegador e o servidor, trocam ambas o código.
Como se resolve?
Inicie uma nova autorização. Encaminhe o titular da conta de novo para o URL de autorização do TikTok; se já aprovou as mesmas permissões, o TikTok, por predefinição, salta a página de revisão e redireciona logo de volta com um código novo. Troque-o uma vez, dentro de 10 minutos, no servidor, com redirect_uri definido como o URL de redirecionamento configurado na aplicação, e guarde os tokens que devolve.
Erros comuns
- Guardar o código para mais tarde. Dura 10 minutos, por isso troque-o assim que o redirecionamento chegar.
- Repetir a tentativa com o mesmo código depois do 40110. O código continua cancelado, usado ou expirado, e só uma nova autorização dá um que funcione.
- Acrescentar parâmetros de consulta ao URL de redirecionamento. O TikTok quer um URL HTTPS estático terminado em /, com os valores de que a aplicação precisa transportados no parâmetro state.
- Enviar um redirect_uri diferente do definido na aplicação. O endpoint de token do TikTok exige que os dois sejam iguais.
Se o início de sessão não puder ser concluído, recomeçar a partir do painel obtém um código novo, e o Claude, o ChatGPT ou o seu próprio código passam a trabalhar com a conta ligada. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Porque é que o TikTok diz que o auth_code está 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á foi usado ou expirou, e só uma nova autorização dá 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 indica para o 40110.
O titular da conta tem de aprovar de novo cada permissão?
Não por predefinição. O TikTok salta a página de revisão para as permissões que o titular já aprovou, a menos que o URL de autorização tenha disable_auto_auth=1.
Em que é que o 40110 difere do 40131?
O 40110 diz respeito apenas 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 ID ou um segredo de aplicação errado.
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