Skip to main content

​
O que isso significa

401 Unauthorized - Sua solicitação não possui credenciais de autenticação válidas.

​
Causas comuns

  • Chave de API inválida ou ausente
  • Chave de API incluída no local errado
  • Regras de Controle de Acesso bloqueando sua solicitação
  • Chave de API expirada ou revogada

​
Soluções

  1. Verifique o formato da sua chave de API
  2. Verifique o posicionamento da chave de API
    • Certifique-se de que a chave de API está nos parâmetros de consulta
    • Verifique se não há espaços extras ou caracteres
  3. Revise as Regras de Controle de Acesso
    • Verifique suas configurações de painel para restrições de IP
    • Verifique se seu domínio está na lista de permissões ao usar solicitações de navegador
Para configuração detalhada de autenticação, veja nosso guia de Autenticação.

​
O que isso significa

429 Too Many Requests - Você excedeu os limites de taxa do seu plano.

​
Causas comuns

  • Fazer solicitações mais rápido do que seu plano permite
  • Tráfego em rajada excedendo limites instantâneos
  • Várias aplicações compartilhando a mesma chave de API
  • Código ineficiente fazendo solicitações redundantes

​
Soluções

  1. Monitore seu uso
    • Verifique o gráfico Rate Limited Requests no seu painel
    • Revise quais endpoints estão atingindo limites
  2. Otimize suas solicitações
    • Armazene respostas em cache quando possível
    • Agrupe múltiplas operações em chamadas únicas
    • Remova polling desnecessário ou solicitações duplicadas
  3. Implemente limitação de taxa
    • Adicione atrasos entre solicitações em sua aplicação
    • Use backoff exponencial para reintentos
  4. Considere uma atualização
Os limites de taxa são reiniciados a cada minuto, então a limitação temporária geralmente é resolvida rapidamente.

​
O que isso significa

500 Internal Server Error - Um erro do lado do servidor ocorreu ao processar sua solicitação.

​
Causas comuns

  • Payload de solicitação malformado
  • Servidor enfrentando problemas temporários
  • Parâmetros inválidos causando erros no servidor
  • Problemas de conectividade de rede

​
Soluções

  1. Valide sua solicitação
    • Certifique-se de que o payload JSON está formatado corretamente
    • Verifique se todos os parâmetros necessários estão incluídos
    • Confira se os tipos de parâmetros correspondem à especificação da API
  2. Verifique o status do serviço
  3. Implemente lógica de reintento
    • Aguarde alguns segundos antes de tentar novamente
    • Use backoff exponencial para múltiplas tentativas
  4. Obtenha suporte
    • Se os erros persistirem, entre em contato com o suporte com os detalhes da sua solicitação
    • Inclua o payload exato da solicitação e o carimbo de data/hora
Erros de servidor são tipicamente temporários e geralmente se resolvem automaticamente.

​
O que isso significa

503 Service Unavailable - O servidor está temporariamente sobrecarregado ou passando por manutenção.

​
Causas comuns

  • Alta carga de tráfego causando sobrecarga temporária
  • Janelas de manutenção agendada
  • Limites de capacidade do servidor alcançados
  • Problemas de infraestrutura de rede

​
Soluções

  1. Aguarde e tente novamente
    • Aguarde 30-60 segundos antes de tentar novamente
    • Esse erro geralmente se resolve à medida que a carga é balanceada
  2. Implemente reintentos inteligentes
    • Use backoff exponencial (comece com 1s, depois 2s, 4s, etc.)
    • Defina um limite máximo de reintentos (3-5 tentativas)
    • Adicione jitter para evitar efeitos de rajada
  3. Verifique a manutenção
  4. Distribua a carga
    • Se possível, espalhe as solicitações ao longo do tempo
    • Evite padrões de rajada que possam acionar a proteção contra sobrecarga
Os erros 503 são projetados para serem temporários - o serviço se recupera automaticamente à medida que a carga do servidor diminui.

​
O que isso significa

504 Gateway Timeout - O servidor não recebeu uma resposta dos serviços upstream dentro do período de tempo limite.

​
Causas comuns

  • Problemas de conectividade de rede
  • Operações complexas excedendo limites de tempo limite
  • Respostas lentas da blockchain durante alta congestão de rede
  • Solicitações de dados grandes demorando muito para processar

​
Soluções

  1. Verifique sua conexão
    • Certifique-se de que sua conexão com a internet está estável
    • Teste com uma solicitação simples para descartar problemas locais
  2. Otimize solicitações grandes
    • Divida grandes solicitações em partes menores
    • Use paginação para consultas pesadas de dados
    • Considere usar conexões WebSocket para dados em tempo real
  3. Implemente tempos limite
    • Defina valores de tempo limite apropriados no seu código de cliente (30-60 segundos)
    • Lide com erros de tempo limite graciosamente com reintentos
  4. Monitore o status do serviço
Os tempos limite de gateway geralmente indicam congestão de rede ou operações complexas. Considere dividir grandes solicitações em partes menores.

​
Precisa de mais ajuda?

Contactar Suporte

Obtenha ajuda da nossa equipe através do Discord, chat, ou suporte por email.

Página de Status

Verifique a disponibilidade e informações de desempenho do serviço em tempo real.