Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Erro 40002 do TikTok: erro de parâmetro no pedido

O erro 40002 do TikTok é um erro de parâmetro: um campo do pedido está em falta, num formato errado, não é suportado ou é incompatível com outro campo. A mensagem da resposta indica o problema, por exemplo um campo obrigatório em falta. Corrija esse campo na referência do endpoint, como business_id, post_info ou max_count na Accounts API, e volte a enviar o pedido.

A easyCoexistence adiciona business_id a cada chamada ao TikTok que faz para o Claude, o ChatGPT ou o seu próprio código, e verifica uma publicação antes de a enviar: um vídeo ou de 1 a 35 imagens, em ligações HTTPS, recusando fotos PNG, já que o TikTok aceita apenas JPEG ou WebP.

40002

Código de retorno do TikTok para um erro de parâmetro, com os detalhes na mensagem da resposta.

HTTP 200

Na resposta de exemplo 40002 do TikTok, é o campo code, e não o estado HTTP, que mostra a falha.

2,200

Caracteres, contados em UTF-16, que uma legenda de vídeo pode ter pela Accounts API, incluindo até 30 menções.

1 to 30

Comentários por página que /business/comment/list/ aceita em max_count; o valor predefinido é 20.

60 days

A data mais antiga a que start_date pode recuar ao ler as estatísticas da conta em /business/get/.

O que significa o erro 40002?

Um ou mais parâmetros não correspondem ao que o endpoint aceita. O anexo de códigos de retorno do TikTok lista o 40002 como erro de parâmetro e indica que se consulte a mensagem de erro para os detalhes. As causas indicadas são campos obrigatórios em falta, formato incorreto, campos ou valores não suportados, campos incompatíveis entre si, precisão de dados inválida e um número inválido.

Como se lê a resposta?

Comece pela mensagem, que indica o campo. O exemplo do próprio TikTok, abaixo, devolve HTTP 200 com a mensagem "Missing required field(s): account_id." Outro exemplo do anexo diz "Time format should be %Y-%m-%dT%H:%M." Guarde também o request_id, uma vez que as referências do TikTok o pedem nos relatórios de problemas.

TikTok's example 40002 response
HTTPS/1.1 200 OK
{
    "code": 40002,
    "message": "Missing required field(s): account_id.",
    "request_id": "2022110918305001025108614416C7CC00"
}

Que regras da Accounts API vale a pena verificar?

Cada referência de endpoint define as suas próprias. Estas são as regras por trás das chamadas que uma ligação faz para publicar, gerir comentários e ler estatísticas:

  • Em cada chamada: business_id, definido com o open_id devolvido com o token de acesso da conta.
  • Publicações de vídeo: video_url e post_info são ambos obrigatórios, post_info mesmo quando vazio; as legendas podem ter até 2.200 caracteres.
  • Publicações de fotografias: até 35 URLs de imagens em photo_images, um privacy_level que a conta permita e um título de até 90 caracteres.
  • Comentários: video_id é o item_id de uma publicação obtido em /business/video/list/, max_count vai de 1 a 30, e comment_ids aceita no máximo 30.
  • Respostas: texto de até 1.200 caracteres, ou uma imagem em seu lugar.
  • Estatísticas: datas escritas como 2021-06-01, em UTC, que recuam no máximo 60 dias.

Como se corrige?

Encontre o campo que a mensagem indica na referência do endpoint, corrija-o e volte a enviar o pedido. O erro descreve o próprio pedido, pelo que, se for reenviado sem alterações, devolve o mesmo código. Para valores que dependem da conta, como os níveis de privacidade ou se os comentários podem ser ativados, leia as opções permitidas em /business/video/settings/ antes de publicar.

E os problemas no ficheiro multimédia?

O TikTok comunica-os depois da chamada. Os endpoints de publicação devolvem um share_id para a tarefa de publicação enquanto o TikTok transfere o ficheiro, e quando o ficheiro viola uma regra, /business/publish/status/ indica FAILED com um motivo como file_format_check_failed, frame_rate_check_failed ou picture_size_check_failed. O TikTok marca esses motivos como não passíveis de nova tentativa, pelo que o próprio ficheiro tem de ser alterado.

Erros comuns

  • Reenviar o mesmo pedido. O 40002 descreve os parâmetros, pelo que nada muda até corrigir o campo que a mensagem indica.
  • Escrever parâmetros de lista como texto simples. Campos como fields são enviados como arrays JSON, como no exemplo do TikTok ["display_name", "profile_image"].
  • Usar uma única definição de privacidade para todas as contas. As opções diferem entre contas públicas e privadas, pelo que deve começar por ler privacy_level_options em /business/video/settings/.
  • Definir disable_comment como false numa conta com os comentários desativados. Quando comment_disabled indica true, o TikTok aceita apenas true.
Fazer isto com a EasyCoexistence

Quando o TikTok continua a responder 40002, a ferramenta devolve o código e a mensagem, para que a sua IA corrija o campo e volte a tentar. 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 é um erro de parâmetro na API do TikTok?

É o código de retorno 40002: um campo do pedido está em falta, mal formatado, não é suportado ou é incompatível com outro campo, e a mensagem indica qual.

Porque envia o TikTok o erro 40002 com HTTP 200?

Os códigos de retorno do TikTok têm prioridade sobre o estado HTTP, pelo que uma resposta 200 cujo código não seja 0 é, ainda assim, uma chamada falhada.

Devo repetir o erro 40002?

Só depois de alterar o pedido. Os parâmetros causam o erro, pelo que deve corrigir o campo que a mensagem indica antes de o voltar a enviar.

Onde aparecem os problemas com o ficheiro de vídeo?

No estado da publicação. Depois de o TikTok transferir o conteúdo multimédia, um ficheiro que viole as suas regras faz com que /business/publish/status/ indique FAILED, com um motivo que nomeia a verificação que falhou.

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