Referência de Erros da API do ThreadsGuia completo de resolução de problemas com soluções
Referência abrangente para erros da API do Threads. Encontre soluções e resolva problemas comuns de integração.
Categorias de Erros
Authentication
3 errors
Media
1 error
Video
3 errors
Todos os Códigos de Erro
#Authentication
revoked_access_tokenrefresh-tokenO token de acesso do Threads é inválido ou foi revogado. Por favor, reconecte sua conta do Threads.
Solução:
Seu token de acesso do Threads foi revogado. Isso acontece quando você remove permissões do aplicativo ou a segurança do Instagram detecta atividade suspeita. Reconecte sua conta.
token is invalidrefresh-tokenO token de acesso do Threads é inválido ou foi revogado. Por favor, reconecte sua conta do Threads.
Solução:
Seu token não é mais válido. Os tokens do Threads estão vinculados a contas do Instagram. Reconecte sua conta do Threads através da conta empresarial do Instagram.
session has been invalidatedrefresh-tokenSua sessão do Threads expirou. Por favor, reconecte sua conta do Threads.
Solução:
Sua sessão do Threads expirou. Isso pode acontecer após alterações de senha ou verificações de segurança. Reconecte sua conta do Threads para estabelecer uma nova sessão.
#Media
media processingretryO Threads ainda está processando sua mídia. Tentando novamente...
Solução:
O Threads ainda está processando a mídia que você enviou. Isso é normal e o sistema tentará automaticamente novamente. Vídeos grandes podem levar mais tempo para serem processados.
#Video
video formatuser-errorFormato de vídeo não suportado. Por favor, assegure-se de que o vídeo esteja no formato MP4 H.264/AAC.
Solução:
Threads requer vídeos MP4 com codec H.264 e áudio AAC. Converta seu vídeo para este formato usando ferramentas como FFmpeg ou HandBrake.
video codecuser-errorFormato de vídeo não suportado. Por favor, assegure-se de que o vídeo esteja no formato MP4 H.264/AAC.
Solução:
Codec de vídeo não suportado. Utilize codecs H.264 (vídeo) e AAC (áudio). Evite usar HEVC/H.265 ou outros codecs modernos que o Threads ainda não suporta.
duration exceeduser-errorA duração do vídeo excede o limite do Threads (máximo de 5 minutos).
Solução:
Os vídeos do Threads devem ter 5 minutos ou menos. Corte seu vídeo para se encaixar nesse limite. Considere dividir conteúdos mais longos em várias publicações.
Melhores Práticas
Tratamento de Erros
- →Gerencie automaticamente os atrasos no processamento de mídia.
- →Valide o formato do vídeo antes de fazer o upload.
- →Monitore a expiração do token
- →Implemente a lógica de repetição para o processamento de mídia.
Dicas de Prevenção
- →Utilize o formato MP4 H.264/AAC para vídeos.
- →Mantenha os vídeos com menos de 5 minutos.
- →Reconectar conta após mudanças de senha do Instagram
- →Aguarde a conclusão do processamento da mídia.
Precisa de ajuda com Threads Integration?
Nossa API gerencia automaticamente cenários de erro com uma lógica de reintento inteligente e registro detalhado.