Referência de Erros da API do TikTokGuia completo de resolução de problemas com soluções
Referência abrangente para erros da API do TikTok. Encontre soluções para detecção de spam, erros de formato de vídeo, permissões de escopo e limites de taxa.
Categorias de Erros
Authentication
3 errors
Spam
6 errors
Formato de Vídeo
6 errors
Media
3 errors
Limite de Taxa
2 errors
Estado do Aplicativo
3 errors
Server
2 errors
Todos os Códigos de Erro
#Authentication
access_token_invalidrefresh-tokenO token de acesso do TikTok é inválido. Por favor, reconecte sua conta do TikTok.
Solução:
Seu token de acesso não é mais válido. Vá para as configurações da conta e reconecte sua conta do TikTok para obter um novo token válido.
scope_not_authorizedrefresh-tokenFaltam permissões obrigatórias do TikTok. Por favor, reconecte-se com todos os escopos necessários.
Solução:
Você não concedeu todas as permissões necessárias. Ao reconectar, certifique-se de aprovar todos os escopos solicitados, incluindo video.upload e user.info.basic.
scope_permission_missedrefresh-tokenPermissões adicionais necessárias, por favor, reautentique-se.
Solução:
Additional permissions are needed for this operation. Reconnect your TikTok account and ensure all permissions are granted.
#Spam
spam_risk_user_banned_from_postinguser-errorConta banida de postar. Por favor, verifique o status da sua conta TikTok.
Solução:
Sua conta do TikTok foi restringida de fazer postagens. Acesse o TikTok diretamente para verificar se há algum aviso. Você pode precisar recorrer da restrição.
spam_risk_textuser-errorO TikTok detectou potencial spam no texto da publicação.
Solução:
Sua legenda ou texto foi sinalizado como spam. Evite conteúdo repetitivo, links excessivos ou linguagem promocional. Tente postar conteúdo diferente.
spam_risk_too_many_postsuser-errorLimite diário de publicações atingido. Tente novamente amanhã.
Solução:
Você ultrapassou o limite diário de postagens do TikTok. Aguarde 24 horas antes de postar novamente. Considere espalhar suas postagens ao longo de vários dias.
spam_risk_too_many_pending_shareuser-errorO limite diário de upload da API foi atingido para o usuário atual.
Solução:
Para reduzir o spam, o TikTok limita o número de vídeos que podem ser enviados via API que não estão pendentes de aprovação e postagem pelo criador. Pode haver no máximo 5 compartilhamentos pendentes em um período de 24 horas.
spam_riskuser-errorO TikTok detectou potencial spam.
Solução:
O sistema de detecção de spam do TikTok sinalizou seu conteúdo. Certifique-se de que seu conteúdo é original e segue as diretrizes da comunidade do TikTok. Evite postagens repetitivas.
reached_active_user_capuser-errorQuota de usuários ativos diários atingida, por favor, tente novamente mais tarde.
Solução:
Seu aplicativo atingiu o limite diário de usuários ativos. Esse limite é definido pelo TikTok com base no status do seu aplicativo. Aguarde 24 horas ou solicite um aumento de cota.
#Formato de Vídeo
file_format_check_faileduser-errorO formato do arquivo é inválido. Verifique as especificações do vídeo do TikTok.
Solução:
O formato do seu vídeo não é suportado. O TikTok requer formatos MP4 ou WebM. Converta seu vídeo e garanta que ele atenda às especificações do TikTok.
duration_check_faileduser-errorA duração do vídeo é inválida. Por favor, verifique as especificações de vídeo do TikTok.
Solução:
A duração do vídeo deve estar entre 3 segundos e 10 minutos. Corte seu vídeo para se ajustar a esses limites.
frame_rate_check_faileduser-errorA taxa de quadros do vídeo é inválida. Verifique as especificações do vídeo do TikTok.
Solução:
O TikTok requer uma taxa de quadros entre 23-60 fps. Reencodifique seu vídeo com uma taxa de quadros suportada.
picture_size_check_faileduser-errorO tamanho da imagem / vídeo é inválido, deve ter pelo menos 720p.
Solução:
A resolução do seu vídeo é muito baixa. O TikTok exige uma resolução mínima de 720p. Utilize uma fonte de vídeo de maior qualidade.
video durationuser-errorA duração do vídeo excede os limites do TikTok. Por favor, utilize um vídeo mais curto.
Solução:
O seu vídeo é demasiado longo. A duração máxima é de 10 minutos. Edite o seu vídeo para que seja mais curto ou divida-o em várias partes.
file sizeuser-errorO tamanho do arquivo excede os limites do TikTok. Por favor, utilize um arquivo menor.
Solução:
O tamanho máximo de arquivo para vídeos é geralmente de 287MB. Comprime o teu vídeo ou reduz a sua qualidade para atender ao limite de tamanho.
#Media
video_pull_faileduser-errorFalha ao extrair o vídeo da URL. Verifique se a URL do vídeo está acessível.
Solução:
O TikTok não conseguiu baixar o seu vídeo da URL fornecida. Verifique se a URL é acessível publicamente, se retorna os cabeçalhos corretos e se o arquivo é válido.
photo_pull_faileduser-errorFalha ao carregar a foto da URL. Verifique se a URL da foto está acessível.
Solução:
O TikTok não conseguiu baixar sua imagem. Verifique se a URL é acessível publicamente e retorna o cabeçalho de tipo de conteúdo correto (image/jpeg ou image/png).
invalid_file_uploaduser-errorFormato de arquivo inválido ou especificações não atendidas.
Solução:
Seu arquivo não atende aos requisitos do TikTok. Verifique se é um arquivo de vídeo/imagem válido em um formato suportado e se atende a todas as especificações.
#Limite de Taxa
rate_limit_exceededretryLimite de taxa do TikTok excedido. Por favor, tente novamente em alguns momentos.
Solução:
Você fez muitas solicitações muito rapidamente. Aguarde alguns minutos antes de tentar novamente. O sistema tentará automaticamente para você.
too many requestsretryLimite de taxa do TikTok excedido. Tente novamente em alguns momentos.
Solução:
O TikTok está limitando suas solicitações. Reduza a frequência das chamadas de API e implemente um retrocesso exponencial na sua lógica de tentativas.
#Estado do Aplicativo
unaudited_client_can_only_post_to_private_accountsuser-errorSeu aplicativo está em modo de desenvolvimento e só pode postar de forma privada. Por favor, envie para revisão do TikTok para postagem pública.
Solução:
Seu aplicativo TikTok não está aprovado para produção. Envie seu aplicativo para o processo de revisão do TikTok para habilitar as capacidades de postagem pública.
url_ownership_unverifieduser-errorPropriedade da URL não verificada, por favor, verifique a propriedade do domínio.
Solução:
Você precisa verificar a propriedade de quaisquer URLs externas em suas postagens. Adicione o código de verificação ao seu domínio ou use o console de desenvolvedor do TikTok para verificar.
privacy_level_option_mismatchuser-errorIncompatibilidade de nível de privacidade, por favor, verifique as configurações de privacidade.
Solução:
O nível de privacidade que você especificou não corresponde às capacidades do seu aplicativo ou às configurações da conta. Revise as permissões do seu aplicativo e as configurações de privacidade.
#Server
internalretryThere is a problem with TikTok servers, please try again later.
Solução:
TikTok is experiencing server issues. This is temporary. Wait a few minutes and try again. The system will automatically retry.
invalid_paramsuser-errorInvalid request parameters, please check content format.
Solução:
One or more parameters in your request are invalid. Review the TikTok API documentation and ensure all required fields are present and correctly formatted.
Melhores Práticas
Tratamento de Erros
- →Implemente estratégias para evitar a detecção de spam.
- →Valide o formato e as especificações do vídeo antes de fazer o upload.
- →Gerencie os limites de taxa com retrocesso exponencial
- →Submeter o aplicativo para aprovação em produção
Dicas de Prevenção
- →Utilize o formato MP4/WebM, com resolução mínima de 720p, entre 23 e 60 fps.
- →Mantenha os vídeos entre 3 segundos e 10 minutos.
- →Evite conteúdo repetitivo ou promocional.
- →Verifique a propriedade do domínio para URLs externas.
Precisa de ajuda com TikTok Integration?
Nossa API gerencia automaticamente cenários de erro com uma lógica de reintento inteligente e registro detalhado.