Começando
1. Crie sua Chave de API
1
Cadastre-se ou faça login
Crie uma conta no Helius Dashboard ou faça login na sua conta existente.
2
Navegue até Chaves de API
Vá para a seção Chaves de API na barra lateral do seu dashboard.
3
Gere uma nova chave
Clique em Criar Nova Chave de API e forneça um nome descritivo para seu projeto (por exemplo, “Aplicativo de Produção”, “Ambiente de Desenvolvimento”).
4
Copie e proteja sua chave
Copie sua chave de API imediatamente e armazene-a com segurança. Você não poderá vê-la novamente após sair da página.
2. Usando sua Chave de API
Inclua sua chave de API como um parâmetro na query em todas as requisições:Começando (Para Agentes)
Agentes podem se inscrever programaticamente para contas Helius, criar projetos e gerar chaves de API usando o Helius CLI. Para instruções completas, leia: https://dashboard.helius.dev/agents.mdInstale o Helius CLI
Gere um Par de Chaves
Financie a Carteira Gerada (somente Autopay)
Pule esta etapa se for pagar via link de pagamento hospedado (--pay / --resume). Para autopay, envie 1 USDC e 0.001 SOL para o endereço da carteira fornecido na Etapa 2.
Inscreva-se e Obtenha a Chave de API
Melhores Práticas de Segurança
Variáveis de Ambiente
Armazene sua chave de API em variáveis de ambiente, não no seu código-fonte.
Restrições de IP
Configure restrições de IP para suas chaves de API no dashboard para limitar o acesso a endereços IP ou intervalos específicos.
Chaves Separadas
Use chaves de API diferentes para ambientes de desenvolvimento, teste e produção para isolar o uso e melhorar a segurança.
Monitorar Uso
Verifique regularmente seu uso de API no dashboard para detectar padrões incomuns ou possíveis problemas de segurança.
Gestão de Segredos
- Node.js
- Python
- Docker
Limites de Taxa e Uso
Os limites de taxa variam conforme o plano de assinatura. Monitore seu uso no Helius Dashboard para garantir que você esteja dentro dos limites alocados.
Entendendo os Limites de Taxa
- Requisições por segundo: Com base no seu nível de assinatura
- Quota de requisições mensais: Total de requisições permitidas por ciclo de cobrança
- Permissão de Estouro: Picos de curto prazo acima do seu limite base de taxa
Lidando com os Limites de Taxa
Solução de Problemas
Erro de Chave de API Inválida
Erro de Chave de API Inválida
Sintomas: 401 Unauthorized ou erros de “Chave de API Inválida”Soluções:
- Verifique se sua chave de API está correta e não foi regenerada
- Verifique se você está incluindo a chave de API como um parâmetro na query:
?api-key=YOUR_KEY - Certifique-se de que não há espaços ou caracteres extras na sua chave de API
- Confirme se sua chave de API não expirou ou foi revogada
Limite de Taxa Excedido
Limite de Taxa Excedido
Sintomas: Erros 429 Too Many RequestsSoluções:
- Verifique seu uso atual no dashboard
- Implemente o backoff exponencial na sua lógica de reintento
- Considere atualizar seu plano para limites mais altos
- Otimize suas requisições para reduzir chamadas desnecessárias
Acesso Proibido
Acesso Proibido
Sintomas: Erros 403 ForbiddenSoluções:
- Verifique se as restrições de IP não estão bloqueando suas requisições
- Verifique se sua assinatura inclui acesso ao endpoint
- Certifique-se de que sua chave de API tem as permissões necessárias
Próximos Passos
Guia de Início Rápido
Comece a fazer suas primeiras chamadas de API com Helius
Referência da API
Explore todos os endpoints e métodos disponíveis
Limites de Taxa
Entenda os limites de taxa e opções de upgrade
Dashboard
Monitore seu uso de API e gerencie chaves
Suporte
Precisa de ajuda com autenticação ou tem perguntas sobre chaves de API?Comunidade no Discord
Participe do nosso Discord para suporte em tempo real e ajuda da comunidade
Suporte por Email
Entre em contato diretamente com nossa equipe de suporte