Erro 40131 do TikTok: erro de autenticação nos endpoints de token
O erro 40131 do TikTok é um erro de autenticação em /tt_user/oauth2/token/ ou /tt_user/oauth2/refresh_token/, os endpoints que emitem e renovam os tokens das contas do TikTok. O TikTok indica três causas: um ID ou segredo de app incorreto, um código de autorização expirado ou um refresh token inválido ou expirado. O endpoint que devolveu o erro indica qual o dado a verificar em primeiro lugar.
O easyCoexistence trata automaticamente das duas chamadas de token: troca o código de autorização assim que o TikTok o devolve após o início de sessão, e renova o access token de 24 horas com o refresh token, sem intervenção.
O código de devolução do TikTok para um erro de autenticação em /tt_user/oauth2/token/ ou /tt_user/oauth2/refresh_token/.
Quanto tempo é válido um código de autorização da Accounts API; cada código só pode ser utilizado uma vez.
Quanto tempo é válido um refresh token; depois de expirar, o titular tem de voltar a autorizar a app.
O erro HTTP que o anexo do TikTok refere poder resultar de chamar /tt_user/oauth2/refresh_token sem a barra final.
O que significa o erro 40131?
Um pedido para obter ou renovar um token de conta do TikTok falhou na autenticação. O anexo de códigos de devolução 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 access token. A mensagem de exemplo é "Authorization code is expired." São indicadas três causas comuns:
- O ID ou o segredo da app está incorreto.
- O código de autorização expirou.
- O refresh token é inválido ou expirou.
Como corrigir no /tt_user/oauth2/token/?
Verifique os três dados que o TikTok indica para este endpoint: o ID da app, o segredo e o código de autorização. O ID e o segredo estão no portal TikTok API for Business, em My Apps, App Detail, Basic Information. O código dura 10 minutos e funciona uma só vez, pelo que deve ser trocado assim que o redirecionamento chegar; se estiver demasiado antigo, inicie de novo a autorização. O redirect_uri enviado com ele tem também de coincidir com o URL de redirecionamento definido na app.
Como corrigir no /tt_user/oauth2/refresh_token/?
Envie um refresh token válido. Confirme que o pedido leva o refresh token guardado mais recentemente para essa conta, junto com o ID e o segredo da app corretos. Se o refresh token tiver expirado ou deixado de ser válido, o anexo do TikTok indica que o titular deve voltar a autorizar a app, o que emite um novo access token e um novo refresh token.
Que códigos relacionados indicam uma só causa?
O mesmo anexo lista códigos mais específicos para alguns destes casos, cada um com a sua descrição:
- 40103: o refresh token expirou, e o titular tem de voltar a autorizar a app.
- 40107: o refresh token é inválido ou incorreto.
- 40110: o código de autorização foi cancelado, já foi usado ou expirou.
- 40113: a app está bloqueada ou não existe, sendo um ID ou segredo incorreto as causas mais comuns.
Erros comuns
- Omitir a barra final. O anexo do TikTok refere que /tt_user/oauth2/refresh_token sem a / final pode devolver 404 page not found em vez de um código de devolução.
- Trocar um código de autorização duas vezes. Só funciona uma vez e durante 10 minutos, pelo que um callback recarregado ou repetido não o pode voltar a usar.
- Pedir ao titular que volte a autorizar antes de verificar o ID e o segredo da app. Se estes estiverem errados, uma nova autorização falha no mesmo ponto.
- Usar credenciais de outra app. O ID e o segredo têm de pertencer à app que o titular da conta autorizou.
Se o TikTok recusar uma renovação, a ferramenta entrega ao Claude, ao ChatGPT ou ao seu próprio código o código e a mensagem do TikTok, e voltar a ligar a conta a partir do painel inicia uma nova autorização. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que se acrescentam ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Que endpoints devolvem o erro 40131 do TikTok?
/tt_user/oauth2/token/, que converte um código de autorização em tokens, e /tt_user/oauth2/refresh_token/, que renova o access token.
Onde estão o ID e o segredo da app do TikTok?
No portal TikTok API for Business, em My Apps, depois App Detail, depois Basic Information.
O erro 40131 obriga sempre o titular a voltar a ligar a conta?
Não. Um ID ou segredo errado corrige-se nas definições da própria app. Uma nova autorização é necessária quando o código de autorização ou o refresh token expirou.
Quanto tempo dura um código de autorização do TikTok para o pedido de token?
10 minutos, e apenas para uma troca. Depois disso, a orientação do TikTok é reiniciar os passos de autorização.
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