Erro 40131 do TikTok: erro de autenticação nos endpoints de token
O erro 40131 do TikTok é um erro de autenticação retornado por /tt_user/oauth2/token/ ou /tt_user/oauth2/refresh_token/, os endpoints que emitem e renovam os tokens das contas do TikTok. O TikTok aponta três causas: app ID ou secret incorreto, código de autorização expirado ou refresh token inválido ou expirado. O endpoint que retornou o erro indica qual dado verificar primeiro.
O easyCoexistence faz as duas chamadas de token por você: troca o código de autorização assim que o TikTok redireciona você de volta após o login e renova sozinho, com o refresh token, o token de acesso de 24 horas.
Código de retorno do TikTok para um erro de autenticação em /tt_user/oauth2/token/ ou /tt_user/oauth2/refresh_token/.
Por quanto tempo um código de autorização da Accounts API é válido; cada código só pode ser usado uma vez.
Por quanto tempo um refresh token é válido; depois que ele expira, o titular precisa autorizar o app de novo.
O erro HTTP que, segundo o apêndice do TikTok, pode surgir ao chamar /tt_user/oauth2/refresh_token sem a barra final.
O que significa o erro 40131?
Uma requisição para obter ou renovar o token de uma conta do TikTok falhou na autenticação. O apêndice de códigos de retorno associa o 40131 a dois endpoints: /tt_user/oauth2/token/, que troca um código de autorização por tokens, e /tt_user/oauth2/refresh_token/, que renova o token de acesso. A mensagem de exemplo é "Authorization code is expired." O apêndice lista três causas comuns:
- O app ID ou o secret está incorreto.
- O código de autorização expirou.
- O refresh token é inválido ou expirou.
Como corrigir o erro no /tt_user/oauth2/token/?
Verifique os três dados que o TikTok indica para esse endpoint: o app ID, o secret e o código de autorização. O ID e o secret ficam no portal TikTok API for Business, em My Apps, App Detail, Basic Information. O código vale por 10 minutos e só funciona uma vez, então troque-o assim que o redirecionamento chegar e reinicie a autorização se ele já tiver passado do prazo. O redirect_uri enviado junto também precisa coincidir com a URL de redirecionamento configurada no app.
Como corrigir o erro no /tt_user/oauth2/refresh_token/?
Envie um refresh token válido. Confirme que a requisição leva o refresh token armazenado mais recentemente para essa conta, junto com o app ID e o secret corretos. Se o refresh token expirou ou deixou de ser válido, o apêndice do TikTok orienta pedir ao usuário que autorize o app de novo, o que gera um novo token de acesso e um novo refresh token.
Quais códigos relacionados apontam uma única causa?
O mesmo apêndice lista códigos mais específicos para alguns desses casos, cada um com sua própria descrição:
- 40103: o refresh token expirou, e o usuário precisa autorizar o app de novo.
- 40107: o refresh token é inválido ou incorreto.
- 40110: o código de autorização foi cancelado, já foi usado ou expirou.
- 40113: o app está bloqueado ou não existe, tendo como causas comuns app ID ou secret incorretos.
Erros comuns
- Esquecer a barra final. O apêndice do TikTok observa que /tt_user/oauth2/refresh_token sem a / final pode retornar 404 page not found em vez de um código de retorno.
- Trocar o mesmo código de autorização duas vezes. Ele funciona uma única vez e por 10 minutos, então um callback recarregado ou repetido não consegue usá-lo de novo.
- Pedir ao titular que autorize de novo antes de verificar o app ID e o secret. Se eles estiverem errados, a nova autorização falha no mesmo ponto.
- Usar credenciais de outro app. O app ID e o secret precisam pertencer ao app que o titular da conta autorizou.
Se o TikTok recusar uma renovação, a ferramenta repassa ao Claude, ao ChatGPT ou ao seu próprio código o código e a mensagem do TikTok, e reconectar a conta pelo painel inicia uma nova autorização. De R$ 29,90 a R$ 3,90 por conexão por mês, com o valor 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
Quais endpoints retornam o erro 40131 do TikTok?
/tt_user/oauth2/token/, que transforma um código de autorização em tokens, e /tt_user/oauth2/refresh_token/, que renova o token de acesso.
Onde encontro o app ID e o secret do TikTok?
No portal TikTok API for Business, em My Apps, depois App Detail, depois Basic Information.
O erro 40131 sempre significa que o titular precisa reconectar a conta?
Não. Um app ID ou secret incorreto se corrige nas configurações do próprio app. Uma nova autorização só é necessária quando o código de autorização ou o refresh token expirou.
Quanto tempo vale o código de autorização do TikTok na requisição de token?
10 minutos, e só para uma troca. Depois disso, a orientação do TikTok é reiniciar o processo de autorização.
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