Erro 40102 do TikTok: token de acesso expirado
O erro 40102 do TikTok significa que o token de acesso enviado com o pedido expirou, e o endpoint tem de ser chamado com o token mais recente. Um token de acesso da Accounts API dura um dia. Renove-o ao enviar o refresh token para /tt_user/oauth2/refresh_token/ e repita a chamada. O próprio refresh token dura um ano, após o qual o titular da conta volta a autorizar a aplicação.
O easyCoexistence renova sozinho o token do TikTok de 24 horas com o refresh token, antes de expirar, para que as chamadas feitas pelo Claude, pelo ChatGPT ou pelo seu próprio código sigam com um token atual.
O código de retorno do TikTok para um token de acesso expirado; o endpoint tem de ser chamado com o mais recente.
Durante quanto tempo um token de acesso de conta do TikTok, emitido pela Accounts API, continua válido.
O valor de expires_in, em segundos, no exemplo do TikTok de um token de acesso recém-emitido.
Durante quanto tempo o refresh token continua válido; quando expira, o titular tem de voltar a autorizar a aplicação.
O que significa o erro 40102?
O token de acesso enviado no cabeçalho Access-Token expirou. O anexo de códigos de retorno do TikTok indica o 40102 como token de acesso expirado e diz que o endpoint tem de ser chamado com o mais recente. A solução é usar um token de acesso válido e voltar a tentar.
O código chega no corpo da resposta. A maioria das chamadas à API for Business do TikTok devolve HTTP 200, e é o código de retorno, não o estado HTTP, que indica se a chamada teve êxito.
Quanto tempo dura um token de acesso do TikTok?
Um dia na API for Business. A Accounts API emite um token de acesso de conta do TikTok quando a aplicação troca um código de autorização em /tt_user/oauth2/token/, e a resposta indica a duração em expires_in, 86 400 segundos no exemplo do TikTok. A mesma resposta traz um refresh token, válido durante um ano, que o TikTok recomenda guardar para renovar o token de acesso. Os tokens de acesso de utilizador da TikTok for Developers, usados pela Content Posting API, duram 2 horas.
Como se renova?
Envie o refresh token para /tt_user/oauth2/refresh_token/ com o ID e o segredo da aplicação e com grant_type definido como refresh_token. A resposta traz um novo token de acesso e um novo refresh token: guarde ambos, envie a partir daí o novo token de acesso no cabeçalho Access-Token e repita a chamada que falhou. Renovar antes de o dia acabar evita que as chamadas cheguem ao TikTok com um token expirado.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<SECRET>",
"grant_type": "refresh_token",
"refresh_token": "<REFRESH_TOKEN>"
}'
# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_inQuando é que o titular tem de voltar a autorizar?
Quando a renovação deixa de ser possível. O refresh token é válido durante um ano, e a documentação do TikTok diz que, quando expira, o programador pede ao titular da conta que volte a autorizar a aplicação através do fluxo de autorização. O titular pode também revogar a autorização a qualquer momento na aplicação do TikTok, em Definições e privacidade, Segurança, Gerir permissões de aplicações, e uma nova autorização é então o caminho de regresso.
Erros comuns
- Renovar só depois de uma chamada falhar. Um token que dura um dia expira todos os dias, por isso renove-o com antecedência e evite que as chamadas cheguem ao TikTok com um token antigo.
- Ignorar o refresh token na resposta da renovação. A referência do TikTok diz para o guardar para a próxima renovação, por isso guarde o que cada renovação devolve.
- Verificar apenas o estado HTTP. O TikTok costuma responder com HTTP 200 e coloca o 40102 no campo code, por isso uma verificação só do estado lê a falha como sucesso.
- Guardar cópias do token em vários sítios. Ao renovar uma cópia, as outras chegam ao fim do seu dia e falham com 40102.
Se o TikTok rejeitar o token mesmo assim com 40102, 40104 ou 40105, a ligação fica logo marcada para voltar a ligar e recebe um e-mail. O seu código pode obter o token atual através de get_social_credentials, em vez de guardar uma cópia. De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
O que significa expires_in na resposta de token do TikTok?
São os segundos que faltam até o token de acesso expirar: 86 400, ou seja um dia, no exemplo do TikTok para um token novo da Accounts API. Some-o à hora da resposta para saber quando renovar, antes do 40102.
Um token de acesso expirado do TikTok pode ser renovado?
Sim, enquanto o refresh token for válido. Envie-o para /tt_user/oauth2/refresh_token/, e o TikTok devolve um novo token de acesso com um refresh token.
O erro 40102 significa que a conta tem de voltar a ser ligada?
Não por si só. Um refresh token válido renova o acesso sem o titular; é preciso uma nova autorização apenas quando o refresh token expirou ou o titular revogou o acesso.
Porque é que uma resposta com HTTP 200 contém o erro 40102?
Os códigos de retorno do TikTok têm prioridade sobre o estado HTTP. Uma chamada só teve êxito se o código for 0, seja qual for a linha de estado.
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