Referência de Erros da API do InstagramGuia completo de resolução de problemas com soluções

Solução:

Seu token de acesso do Instagram foi revogado. Isso acontece quando você remove as permissões do aplicativo nas configurações do Instagram. Vá para as configurações da sua conta e reconecte o Instagram com todas as permissões necessárias.

Solução:

Sua sessão do Instagram não é mais válida. Isso pode acontecer após uma alteração de senha ou verificação de segurança. Reconecte sua conta do Instagram para estabelecer uma nova sessão.

Solução:

A API do Instagram requer uma conta de Negócios ou Criador. Converta sua conta: Vá para Configurações do Instagram → Conta → Mudar para Conta Profissional → Escolha Negócios.

Solução:

O Instagram restringiu sua conta. Faça login diretamente no Instagram para verificar se há avisos ou restrições. Pode ser necessário verificar sua identidade ou recorrer da restrição.

Solução:

The app doesn't have required permissions. When reconnecting, ensure you grant all permissions, especially 'instagram_content_publish' and 'instagram_basic'.

Solução:

O Instagram não conseguiu baixar sua mídia a partir da URL dentro do período de tempo limite. Certifique-se de que sua URL de mídia seja acessível publicamente e que o servidor esteja respondendo rapidamente. Tente re-enviar.

Solução:

O recipiente de mídia expirou antes da publicação. Os recipientes de mídia do Instagram expiram após 24 horas. Crie um novo recipiente de mídia e publique-o imediatamente.

Solução:

O Instagram não conseguiu criar o contêiner de mídia. Isso pode ser um problema temporário. Aguarde um momento e tente novamente. Certifique-se de que sua mídia atende às especificações do Instagram.

Solução:

Ocorreu um erro desconhecido durante o upload. Verifique se o seu arquivo de mídia é válido e atende aos requisitos do Instagram. Tente fazer o upload de um arquivo diferente para isolar o problema.

Solução:

O Instagram não conseguiu buscar sua mídia a partir da URL fornecida. Verifique se a URL é acessível publicamente, retorna o cabeçalho de tipo de conteúdo correto e se o arquivo é válido.

Solução:

O contêiner de mídia não foi encontrado. Ele pode ter sido excluído ou expirado. Crie um novo contêiner de mídia e tente novamente.

Solução:

A sessão do construtor de mídia expirou. Isso acontece se muito tempo passar entre a criação do contêiner e a publicação. Crie e publique em um único fluxo.

Solução:

Ocorreu um erro desconhecido. Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o suporte com os detalhes completos do erro.

Solução:

Reduza o tamanho do arquivo da sua imagem. O Instagram tem um tamanho máximo de arquivo de 8MB para imagens. Utilize uma ferramenta de compressão de imagem para diminuir o tamanho do arquivo sem comprometer a qualidade.

Solução:

O Instagram suporta apenas os formatos de imagem JPG e PNG. Converta sua imagem para um desses formatos antes de fazer o upload.

Solução:

O Instagram exige proporções entre 4:5 (retrato) e 1,91:1 (paisagem). Corte ou redimensione sua imagem para se adequar a esses limites.

Solução:

A proporção da sua imagem está fora do intervalo permitido pelo Instagram. Utilize 1:1 (quadrado), 4:5 (retrato) ou 1.91:1 (paisagem). Evite proporções extremas.

Solução:

O Instagram limita a resolução das imagens a 1920x1080 pixels. Redimensione sua imagem para se ajustar a essas dimensões.

Solução:

O Instagram suporta apenas o formato de vídeo MP4 com codec H.264 e áudio AAC. Converta seu vídeo para atender a essas especificações.

Solução:

O deslocamento da miniatura que você especificou é inválido. Deve estar dentro da duração do vídeo. Use um valor entre 0 e a duração do vídeo em milissegundos.

Solução:

O Instagram não conseguiu determinar o tipo de mídia. Certifique-se de que está especificando o parâmetro media_type correto (IMAGE, VIDEO ou CAROUSEL_ALBUM).

Solução:

As legendas do Instagram têm um comprimento máximo de 2.200 caracteres. Encurte sua legenda e tente novamente.

Solução:

A detecção de spam do Instagram sinalizou seu conteúdo. Evite postagens repetitivas, hashtags excessivas ou linguagem considerada spam. Espere um tempo e tente postar conteúdo diferente.

Solução:

O Instagram bloqueou esta solicitação, provavelmente devido a limitações de taxa ou atividade suspeita. Aguarde de 15 a 30 minutos antes de tentar novamente e reduza a frequência de postagens.

Solução:

Seu carrossel não atende aos requisitos do Instagram. Certifique-se de que todos os itens sejam do mesmo tipo (todas imagens ou todos vídeos), tenham proporções consistentes e que você tenha de 2 a 10 itens.

Solução:

Não é possível especificar as posições das etiquetas de produtos para postagens em vídeo. Apenas postagens de imagem suportam etiquetas de produtos posicionadas.

Solução:

Ao marcar produtos em fotos, é necessário especificar as coordenadas x e y para as posições das etiquetas. Forneça os dados de posição para todas as etiquetas de produtos.

Solução:

Um ou mais rótulos de produto são inválidos. Verifique se todos os IDs de produto existem no seu catálogo e se as coordenadas de posição estão entre 0.0 e 1.0.

Solução:

O Instagram limita o número de etiquetas de produtos por postagem. Reduza o número de produtos que você está etiquetando (o máximo é geralmente 5 produtos por imagem).

Solução:

Você atingiu o limite diário de postagens do Instagram. O Instagram permite 25 postagens por dia. Aguarde até o dia seguinte para postar mais conteúdo.

Solução:

O Instagram impõe um limite de 25 publicações por dia. Espere até amanhã para postar mais conteúdo. Considere agendar suas publicações para distribuí-las ao longo de vários dias.

Solução:

O Instagram teve um erro temporário. O sistema tentará novamente automaticamente. Se continuar falhando, aguarde alguns minutos antes de tentar novamente.