EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Erro 40103 do TikTok: refresh token expirado

O erro 40103 do TikTok significa que o refresh token expirou, por isso ele não pode mais renovar o token de acesso da conta. Um refresh token da Accounts API é válido por um ano. A solução indicada pelo TikTok é uma nova autorização: o dono da conta passa de novo pelo fluxo de autorização do app, que devolve um novo token de acesso e um novo refresh token para armazenar no lugar do par antigo.

O easyCoexistence guarda o refresh token e a sua validade de cada renovação do TikTok e renova sozinho o token de acesso de 24 horas, para Claude, ChatGPT ou seu próprio código.

40103

Código de retorno do TikTok para um refresh token expirado; a correção é o usuário autorizar o app novamente.

1 year

Por quanto tempo um refresh token da Accounts API continua válido.

31,536,000

Segundos em refresh_token_expires_in, exatamente um ano, no exemplo do TikTok de tokens recém-emitidos.

10 minutes

Por quanto tempo o código de autorização de uma nova autorização vale, para uso único.

O que significa o erro 40103?

O refresh token enviado para renovar o token de acesso já passou da data de expiração. O apêndice de códigos de retorno do TikTok lista 40103 como refresh token expirado. A correção é usar um refresh token válido e, para obter um, pedir ao usuário que autorize o app novamente pelo fluxo de autorização do usuário. Até isso acontecer, o token de acesso não pode ser renovado, e as chamadas param de funcionar quando o token atual chega ao fim das suas 24 horas.

Quanto tempo dura um refresh token?

Um ano. A resposta de /tt_user/oauth2/token/ inclui refresh_token_expires_in, os segundos restantes até o refresh token expirar: 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 toda renovação começa um novo ano.

Como corrigir?

Peça ao dono da conta que autorize o app novamente. Compartilhe a URL de autorização do titular da conta TikTok; quando ele aprovar, o TikTok redireciona para a URL de redirecionamento do app com um novo auth_code, válido por 10 minutos e de uso único. Troque-o em /tt_user/oauth2/token/ por um novo token de acesso e um novo refresh token, e substitua o par armazenado. Se o dono já tiver aprovado as mesmas permissões antes, o TikTok pula a página de revisão por padrão e o devolve direto ao app.

Em que 40103 difere de 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. Somente 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 app ID ou secret do app errado, código de autorização expirado, ou refresh token inválido ou expirado.

Erros comuns

  • Esperar o 40103 para planejar a próxima autorização. refresh_token_expires_in informa a data com antecedência, então o dono pode ser avisado antes de a renovação parar.
  • Presumir que cada renovação reinicia o ano. O exemplo de renovação do TikTok devolve menos de um ano em refresh_token_expires_in, então leia o valor de toda resposta.
  • Descartar o refresh token que uma renovação devolve. A referência do TikTok diz para guardá-lo para a próxima renovação.
Fazendo isso com o EasyCoexistence

Se o TikTok recusar uma renovação, a ferramenta devolve o código e a mensagem do TikTok, e conectar a conta de novo pelo painel emite um novo par de tokens. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 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

Os refresh tokens da Content Posting API também duram um ano?

Não. Os refresh tokens da TikTok for Developers, usados pela Content Posting API, duram 180 dias; o prazo de um ano vale para os refresh tokens da API for Business, cujos segundos restantes aparecem em refresh_token_expires_in.

Um refresh token expirado do TikTok pode ser renovado?

Não. A correção do TikTok para o 40103 é uma nova autorização pelo dono da conta, que emite um novo token de acesso e um novo refresh token.

O dono vê de novo a página de permissões do TikTok?

Não por padrão. Se ele já tiver aprovado as mesmas permissões antes, o TikTok pula a página de revisão e redireciona para o app com um novo código de autorização.

O que acontece com as chamadas depois que o refresh token expira?

Continuam funcionando até o token de acesso atual chegar ao fim das suas 24 horas. Depois disso falham com 40102, pois o token não pode mais ser renovado.

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