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.
Código de retorno do TikTok para um erro de parâmetro, com os detalhes na mensagem da resposta.
Na resposta de exemplo 40002 do TikTok, é o campo code, e não o estado HTTP, que mostra a falha.
Caracteres, contados em UTF-16, que uma legenda de vídeo pode ter pela Accounts API, incluindo até 30 menções.
Comentários por página que /business/comment/list/ aceita em max_count; o valor predefinido é 20.
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.
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 oopen_iddevolvido com o token de acesso da conta. - Publicações de vídeo:
video_urlepost_infosão ambos obrigatórios,post_infomesmo quando vazio; as legendas podem ter até 2.200 caracteres. - Publicações de fotografias: até 35 URLs de imagens em
photo_images, umprivacy_levelque a conta permita e um título de até 90 caracteres. - Comentários:
video_idé oitem_idde uma publicação obtido em /business/video/list/,max_countvai de 1 a 30, ecomment_idsaceita 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.
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