Solução de problemas de falha de chamada de API

Last updated: June 19, 2026

 

Este artigo servirá para compartilhar circunstâncias que resultaram em falhas de API para clientes. Na maioria das vezes, quando o Suporte L2L é contatado sobre uma chamada de API com falha, uma das situações a seguir é identificada como a causa. Sinta-se sempre à vontade para entrar em contato conosco; teremos prazer em ajudar a solucionar o problema com você. 

Também é fundamental que você envolva seu próprio departamento de TI local. Alterações na rede local ou no firewall de um cliente resultam em falhas quando as chamadas de API estavam funcionando corretamente anteriormente. 

 

Quando uma chamada de API falha, geralmente é devido a um dos seguintes motivos: 

1. Um firewall interno às instalações do cliente está bloqueando a chamada de API 

2. Um endereço IP foi alterado ou um endereço IP anteriormente incluído na lista de permissões não está mais incluído 

3. A sintaxe da chamada de API não está correta. Essa é uma ocorrência frequente, geralmente resultante de: 

  • Falta de um parâmetro obrigatório 
  • Um nome ou descrição é usado na chamada quando um CODE é obrigatório 
  • Uma chamada excede o tempo limite, geralmente devido à tentativa de recuperar dados em excesso de 2.000 registros 
  • Uma chamada excede o tempo limite devido a tráfego de API repetido e/ou extremamente alto 

Os firewalls restringem o tráfego por um dos vários motivos. Pergunte à sua equipe local de TI se alguma das situações abaixo ocorreu: 

  • Alteração de endereço(s) IP 
  • Erro de configuração do proxy 
  • Licença(s) expirada(s) 
  • Alterações na política do firewall 

Veja a seguir uma lista de informações a serem fornecidas ao Suporte L2L para nos ajudar a solucionar chamadas de API com falha mais rapidamente: 

  • A chamada de API exata que estava sendo usada 
  • O resultado retornado ou a mensagem de erro 
  • Essa chamada de API já funcionou com sucesso antes? 
  • Quando ela parou de funcionar? A data e a hora também agilizam o processo de solução de problemas tanto para sua equipe local de TI quanto para o Suporte L2L. 
  • Você entrou em contato com o pessoal local de TI? 
  • Seu departamento de TI fez alguma alteração nos endereços IP incluídos na lista de permissões?