Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Erro 40104 do TikTok: o access token está vazio

O erro 40104 do TikTok significa que o pedido chegou sem access token. Os endpoints da API de Contas, como /business/video/list/ e /business/comment/list/, esperam o token da conta do TikTok num cabeçalho chamado Access-Token. Acrescente esse cabeçalho com um token válido, obtido em /tt_user/oauth2/token/ ou renovado com o refresh token, e volte a enviar o pedido.

A easyCoexistence acrescenta o token atual da conta do TikTok, no cabeçalho Access-Token, a cada chamada que faz para o Claude, o ChatGPT ou o seu próprio código.

40104

O código de retorno do TikTok quando o access token está vazio; a correção é enviar um válido.

Access-Token

O cabeçalho obrigatório que transporta o token da conta do TikTok nos endpoints da API de Contas.

business_id

O parâmetro que identifica a conta do TikTok em cada chamada, definido como o open_id devolvido com o seu token.

Bearer

O token_type que o TikTok devolve com o access token de uma conta do TikTok, que continua a ser enviado em Access-Token.

O que significa o erro 40104?

O TikTok recebeu a chamada sem access token. O anexo com os códigos de retorno indica o 40104 como access token vazio, com a mesma correção dos outros erros de token: utilizar um access token válido e voltar a tentar. O pedido chegou ao TikTok, mas nada nele indicava em nome de que autorização atuava, pelo que o TikTok considera a chamada sem êxito.

Onde vai o token?

Num cabeçalho chamado Access-Token. As referências da API de Contas, desde a publicação aos comentários e às métricas, indicam Access-Token como cabeçalho obrigatório, com o token que a conta do TikTok autorizou. A conta em si é indicada à parte, em business_id, definido como o open_id que veio com o token.

An Accounts API call with its token
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["item_id","caption","video_views"]'

Como é que o cabeçalho fica vazio?

O token perde-se algures entre o armazenamento e o pedido. Estes são os pontos a verificar:

  • O cabeçalho tem outro nome. Um token enviado como Authorization: Bearer deixa Access-Token vazio, mesmo que o TikTok indique o tipo do token como Bearer.
  • A variável que guarda o token está vazia, por exemplo depois de uma renovação que falhou sem que o erro fosse verificado.
  • O token viaja no corpo ou na query string em vez do cabeçalho.
  • Reutiliza-se uma função auxiliar escrita para /tt_user/oauth2/token/ e /tt_user/oauth2/refresh_token/; esses endpoints não recebem cabeçalho Access-Token, por isso a função não envia nenhum.

Como se corrige?

Envie o token em Access-Token, juntamente com business_id. Se não houver token atual, obtenha um: renove com /tt_user/oauth2/refresh_token/ enquanto o refresh token for válido, ou peça ao titular da conta que volte a autorizar a aplicação se não estiver. Ao depurar, registe se o cabeçalho está presente e qual o tamanho do valor, em vez do próprio token, já que o TikTok avisa que quem tiver o token o pode utilizar.

Erros comuns

  • Tratar o 40104 como token expirado. O token está ausente, não velho, por isso renová-lo não muda nada enquanto o código não o enviar de facto.
  • Renovar o token sem passar o novo. A renovação devolve um novo access token, e as chamadas seguintes têm de enviar esse valor em Access-Token.
  • Repetir o pedido sem alterações. Sem o cabeçalho, cada tentativa chega ao TikTok da mesma forma e recebe o mesmo código.
Fazer isto com a EasyCoexistence

Se o TikTok responder com 40102, 40104 ou 40105 na mesma, a ligação fica logo marcada para voltar a ligar e recebe um e-mail. 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

Posso enviar um access token do TikTok como Authorization: Bearer?

Não. Os endpoints da API de Contas leem o token do cabeçalho Access-Token; por isso, um token enviado como Authorization: Bearer deixa Access-Token vazio e a chamada devolve 40104, embora o TikTok indique o tipo do token como Bearer.

O 40104 é o mesmo que um token expirado?

Não. O 40104 significa que nenhum token chegou; um token expirado devolve 40102, e um token inválido ou incorreto devolve 40105.

Os endpoints de token do TikTok precisam de Access-Token?

Não. /tt_user/oauth2/token/ e /tt_user/oauth2/refresh_token/ identificam a aplicação com client_id e client_secret no corpo do pedido.

O business_id substitui o token?

Não. O business_id indica a que conta do TikTok diz respeito a chamada, e Access-Token transporta a autorização para agir em nome dela. Cada chamada precisa dos dois.

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