Erro 40103 do TikTok: refresh token expirado
O erro 40103 do TikTok significa que o refresh token expirou, pelo que deixa de poder renovar o access token da conta. Um refresh token da Accounts API é válido durante um ano. A solução indicada pelo TikTok é uma nova autorização: o titular da conta volta a percorrer o fluxo de autorização da aplicação, o que devolve um novo access token e um novo refresh token, a guardar no lugar do par anterior.
A easyCoexistence guarda o refresh token e a respetiva expiração de cada renovação do TikTok e renova o access token de 24 horas por conta própria, para o Claude, o ChatGPT ou o seu próprio código.
O código de retorno do TikTok para um refresh token expirado; a solução é o utilizador autorizar a aplicação de novo.
Durante quanto tempo um refresh token da Accounts API continua válido.
Segundos em refresh_token_expires_in, exatamente um ano, no exemplo do TikTok para tokens recém-emitidos.
Durante quanto tempo o código de autorização de uma nova autorização é válido, para uma única utilização.
O que significa o erro 40103?
O refresh token enviado para renovar o access token já passou da data de expiração. O apêndice de códigos de retorno do TikTok lista o 40103 como refresh token expirado. A solução é usar um refresh token válido e, para o obter, pedir ao titular da conta que volte a autorizar a aplicação através do fluxo de autorização do utilizador. Até lá, o access token não pode ser renovado, e as chamadas deixam de funcionar quando o token atual chegar ao fim do seu dia.
Quanto tempo dura um refresh token?
Um ano. A resposta de /tt_user/oauth2/token/ inclui refresh_token_expires_in, os segundos que faltam até que o refresh token expire: 31,536,000 no exemplo do TikTok, exatamente um ano. As respostas de renovação trazem o mesmo campo, e o exemplo de renovação do TikTok mostra 28,484,364 segundos, menos de um ano; por isso, leia o valor de cada resposta em vez de presumir que cada renovação começa um novo ano.
Como se corrige?
Peça ao titular da conta que volte a autorizar a aplicação. Partilhe-lhe o URL de autorização do titular da conta TikTok; depois de aprovar, o TikTok redireciona-o para o URL de redirecionamento da aplicação com um novo auth_code, válido durante 10 minutos e utilizável uma só vez. Troque-o em /tt_user/oauth2/token/ por um novo access token e um novo refresh token, e substitua o par guardado. Se o titular já tiver aprovado as mesmas permissões, o TikTok, por predefinição, salta a página de revisão e redireciona-o diretamente.
Em que se distingue o 40103 dos 40107 e 40131?
O apêndice tem três códigos para uma renovação que falha, e cada um aponta para uma verificação diferente:
- 40103: o refresh token expirou. Só uma nova autorização o substitui.
- 40107: o refresh token é inválido ou incorreto, por exemplo um enviado para renovar um token da Marketing API, que nunca expira.
- 40131: erro de autenticação em /
tt_user/oauth2/token/ ou /tt_user/oauth2/refresh_token/, causado por um ID ou segredo da aplicação errado, um código de autorização expirado, ou um refresh token inválido ou expirado.
Erros comuns
- Esperar pelo 40103 para planear a próxima autorização. refresh_token_expires_in indica a data com antecedência, para que o titular seja contactado antes de a renovação parar.
- Presumir que cada renovação recomeça o ano. O exemplo de renovação do TikTok devolve, em refresh_token_expires_in, menos de um ano; leia o valor de cada resposta.
- Descartar o refresh token que uma renovação devolve. A referência do TikTok indica que deve ser guardado para a renovação seguinte.
Se o TikTok recusar uma renovação, a ferramenta devolve o código e a mensagem do TikTok, e voltar a ligar a conta a partir do painel emite um novo par de tokens. De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Os refresh tokens da Content Posting API também duram um ano?
Não. Os refresh tokens do TikTok for Developers, usados pela Content Posting API, duram 180 dias; o tempo de vida de um ano pertence aos refresh tokens da API for Business, cujos segundos restantes aparecem em refresh_token_expires_in.
Um refresh token do TikTok expirado pode ser renovado?
Não. A solução do TikTok para o 40103 é uma nova autorização pelo titular da conta, que emite um novo access token e um novo refresh token.
O titular volta a ver a página de permissões do TikTok?
Não por predefinição. Se já tiver aprovado as mesmas permissões, o TikTok salta a página de revisão e redireciona-o para a aplicação com um novo código de autorização.
O que acontece às chamadas depois de o refresh token expirar?
Continuam a funcionar até o access token atual chegar ao fim do seu dia. Depois falham com 40102, porque o token já não pode ser renovado.
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