EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Erro 40002 do TikTok: erro de parâmetro na requisição

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

O easyCoexistence adiciona business_id a todas as chamadas ao TikTok que faz para o Claude, o ChatGPT ou o seu próprio código, e verifica um post antes de enviá-lo: um vídeo ou de 1 a 35 imagens, em links HTTPS, com fotos PNG recusadas porque o TikTok aceita apenas JPEG ou WebP.

40002

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

HTTP 200

O status do exemplo de resposta 40002 do TikTok, então é o campo code, e não o status, 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 padrão é 20.

60 days

O máximo que um start_date pode recuar quando /business/get/ lê as métricas da conta.

O que significa o erro 40002?

Um ou mais parâmetros não correspondem ao que o endpoint aceita. O apêndice de códigos de retorno do TikTok lista o 40002 como erro de parâmetro e orienta consultar a mensagem de erro para ver os detalhes. As causas citadas são campos obrigatórios ausentes, formato incorreto, campos ou valores não suportados, campos incompatíveis entre si, precisão de dados inválida e número inválido.

Como ler a resposta?

Comece pela mensagem, que indica o campo. O exemplo do próprio TikTok, abaixo, volta com HTTP 200 e a mensagem "Missing required field(s): account_id." Outro exemplo do apêndice diz "Time format should be %Y-%m-%dT%H:%M." Guarde também o request_id, pois as referências do TikTok pedem esse identificador ao reportar problemas.

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

Quais regras da Accounts API vale verificar?

Cada referência de endpoint define as suas. Estas são as regras por trás das chamadas que uma conexão faz para publicar, trabalhar com comentários e ler métricas:

  • Toda chamada: business_id, definido como o open_id que veio com o access token da conta.
  • Posts de vídeo: video_url e post_info são obrigatórios, post_info mesmo quando vazio; legendas aceitam até 2.200 caracteres.
  • Posts de foto: até 35 URLs de imagem 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 um post 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 no lugar dele.
  • Métricas: datas no formato 2021-06-01, em UTC, retroagindo no máximo 60 dias.

Como corrigir?

Encontre na referência do endpoint o campo que a mensagem indica, corrija-o e envie a requisição novamente. O erro descreve a própria requisição, então enviá-la 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 arquivo de mídia?

O TikTok os informa depois da chamada. Os endpoints de publicação retornam um share_id para a tarefa de publicação enquanto o TikTok baixa o arquivo, e quando o arquivo quebra uma regra, /business/publish/status/ mostra 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 repetíveis, então é o próprio arquivo que precisa mudar.

Erros comuns

  • Enviar a mesma requisição de novo. O 40002 descreve os parâmetros, então nada muda até que o campo indicado na mensagem seja corrigido.
  • Escrever parâmetros de array como texto simples. Campos como fields são enviados como arrays JSON, como no exemplo do TikTok ["display_name", "profile_image"].
  • Usar a mesma configuração de privacidade para todas as contas. As opções diferem entre contas públicas e privadas, então leia primeiro privacy_level_options em /business/video/settings/.
  • Definir disable_comment como false em uma conta com os comentários desativados. Quando comment_disabled vem como true, o TikTok aceita apenas true.
Fazendo isso com o EasyCoexistence

Quando o TikTok ainda responde 40002, a ferramenta devolve o código e a mensagem, para que a sua IA corrija o campo e repita a chamada. De R$ 29,90 a R$ 3,90 por conexão por mês, com o preço caindo conforme você adiciona conexões, e 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

O que é um erro de parâmetro na API do TikTok?

É o código de retorno 40002: um campo da requisição está ausente, malformado, não é suportado ou é incompatível com outro campo, e a mensagem indica qual.

Por que o TikTok retorna o erro 40002 com HTTP 200?

Os códigos de retorno do TikTok têm precedência sobre o status HTTP, então uma resposta 200 cujo código não é 0 continua sendo uma chamada que falhou.

Devo repetir a requisição depois do erro 40002?

Só depois de alterá-la. São os parâmetros que causam o erro, então corrija o campo que a mensagem indica antes de enviá-la novamente.

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

No status da publicação. Depois que o TikTok baixa a mídia, um arquivo que quebra suas regras faz /business/publish/status/ mostrar FAILED, com um motivo que nomeia a verificação que falhou.

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