> ## Documentation Index > Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # FAQ de Códigos de Erro > Solucione códigos de erro HTTP ao usar endpoints Helius RPC - identifique e resolva os problemas mais comuns de autenticação, limitação de taxa e servidor ## 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** ``` https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY ``` 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](https://dashboard.helius.dev/) 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](/docs/pt-BR/api-reference/authentication). ## 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](https://dashboard.helius.dev/usage) * 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** * Revise [Planos e Limites de Taxa](/docs/pt-BR/billing/plans) para níveis superiores 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** * Visite a [Página de Status da Helius](https://helius.statuspage.io/) para problemas em andamento * Procure por interrupções relatadas ou desempenho degradado 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** * Reveja a [Página de Status da Helius](https://helius.statuspage.io/) para manutenção agendada * Planeje em torno das janelas de manutenção anunciadas 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** * Verifique a [Página de Status da Helius](https://helius.statuspage.io/) para problemas de rede * Procure relatórios de alta congestão da blockchain 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? Obtenha ajuda da nossa equipe através do Discord, chat, ou suporte por email. Verifique a disponibilidade e informações de desempenho do serviço em tempo real.