A grande maioria dos problemas de integração se resume a uma lista curta de causas. Antes de abrir um chamado, confira este guia: provavelmente a solução está aqui.

1. Chave inválida ou acesso não ativado

Sintoma: todas as requisições retornam erro de autenticação.

Solução: confira se a chave foi copiada completa, sem espaços, e se o acesso à API já foi ativado pelo suporte. Chave certa com acesso inativo também é recusada.

2. Formato do link errado

Sintoma: o pedido é recusado ou consta com erro logo após o envio.

Solução: cada serviço tem seu formato (usuário sem @ para seguidores no Instagram, link completo para curtidas, link com /status/ no X). Confira na documentação e valide no seu código antes de enviar, inclusive removendo espaços nas pontas.

3. Quantidade fora do mínimo ou máximo

Sintoma: recusa imediata do pedido.

Solução: consulte os limites de cada serviço e valide a quantidade no seu sistema antes do envio.

4. Saldo insuficiente

Sintoma: pedidos recusados no meio de um lote.

Solução: consulte o saldo antes de processar lotes e implemente um aviso automático de saldo baixo no seu sistema.

5. Pedido duplicado para o mesmo link

Sintoma: recusa ao reenviar para um link que já tem pedido ativo.

Solução: antes de reenviar, consulte o status do pedido anterior. O bloqueio de duplicados é uma proteção, não um defeito.

6. Caracteres especiais e codificação

Sintoma: links válidos sendo recusados de forma aparentemente aleatória.

Solução: garanta que a requisição envia os dados com a codificação correta e sem caracteres invisíveis (comum ao copiar links de aplicativos, que às vezes trazem parâmetros extras). Envie o link limpo, sem parâmetros de rastreamento.

Precisou de ajuda mesmo assim?

Fale com o suporte informando o usuário da conta, a operação tentada, o conteúdo da requisição (sem a chave!) e a resposta recebida. Com esses dados, o diagnóstico é rápido.