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

Last updated: June 19, 2026

 

Este artigo servirá para partilhar circunstâncias que resultaram em falhas de API para os clientes. Na maioria das vezes, quando o Suporte L2L é contactado relativamente a uma chamada de API falhada, verifica-se que uma das seguintes situações é a causa. Contacte-nos sempre que necessário e teremos todo o gosto em ajudar a resolver o problema consigo. 

É também fundamental que envolva o seu próprio departamento de TI local. Alterações à rede local ou à firewall de um cliente resultam em falhas quando as chamadas de API estavam a funcionar corretamente anteriormente. 

 

Quando uma chamada de API falha, geralmente deve-se a uma das seguintes razões: 

1. Uma firewall interna às instalações do cliente está a bloquear a chamada de API 

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

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

  • Falta um parâmetro obrigatório 
  • É utilizado um nome ou uma descrição na chamada quando é necessário um CÓDIGO 
  • Uma chamada excede o tempo limite, geralmente devido à tentativa de obter dados em excesso de 2 000 registos 
  • Uma chamada excede o tempo limite devido a tráfego de API repetido e/ou extremamente elevado 

As firewalls restringem o tráfego por uma de várias razões. Pergunte à sua equipa de TI local se alguma das situações abaixo ocorreu: 

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

Eis uma lista de informações a fornecer ao Suporte L2L para nos ajudar a resolver mais rapidamente as chamadas de API falhadas: 

  • A chamada de API exata que estava a utilizar 
  • O resultado devolvido ou a mensagem de erro 
  • Esta chamada de API funcionou com sucesso anteriormente? 
  • Quando deixou de funcionar? A data e a hora também aceleram o processo de resolução de problemas, tanto para a sua equipa de TI local como para o Suporte L2L. 
  • Contactou o seu pessoal de TI local? 
  • O seu departamento de TI fez alguma alteração aos endereços IP incluídos na lista de permissões?