Pour Commencer
1. Créez Votre Clé API
1
Inscrivez-vous ou connectez-vous
Créez un compte sur le Tableau de bord Helius ou connectez-vous à votre compte existant.
2
Accédez aux Clés API
Allez dans la section Clés API dans la barre latérale de votre tableau de bord.
3
Générez une nouvelle clé
Cliquez sur Créer une nouvelle clé API et donnez un nom descriptif à votre projet (par exemple, “Application de Production”, “Environnement de Développement”).
4
Copiez et sécurisez votre clé
Copiez immédiatement votre clé API et stockez-la en toute sécurité. Vous ne pourrez plus la voir une fois que vous aurez navigué ailleurs.
2. Utilisation de Votre Clé API
Incluez votre clé API comme paramètre de requête dans toutes les requêtes :Pour Commencer (Pour les Agents)
Les agents peuvent s’inscrire programmatique pour des comptes Helius, créer des projets et générer des clés API en utilisant le Helius CLI. Pour des instructions complètes, lisez : https://dashboard.helius.dev/agents.mdInstallez le Helius CLI
Générez une Paire de Clés
Financez le Portefeuille Généré (Autopay uniquement)
Ignorez cette étape si vous payez via le lien de paiement hébergé (mode d’inscription par défaut, finalisé avechelius signup --resume). Le paiement automatique (--pay) est effectué depuis la paire de clés locale : envoyez le montant du forfait en USDC (10 $ pour le forfait Agent) et environ 0,001 SOL à l’adresse du portefeuille obtenue à l’étape précédente.
Inscription et Obtention de la Clé API
Chaque nouvelle inscription nécessite--email, --first-name et --last-name, y compris pour le forfait Agent. Le portefeuille sert uniquement au paiement.
Bonnes pratiques de sécurité
Environment Variables
Stockez votre clé API dans des variables d’environnement, et non dans votre code source.
IP Restrictions
Configurez des restrictions d’adresses IP pour vos clés API dans le tableau de bord afin de limiter l’accès à des adresses ou plages d’adresses IP spécifiques.
Separate Keys
Utilisez des clés API différentes pour les environnements de développement, de préproduction et de production afin d’isoler l’utilisation et de renforcer la sécurité.
Monitor Usage
Vérifiez régulièrement votre utilisation de l’API dans le tableau de bord afin de détecter toute activité inhabituelle ou tout problème de sécurité potentiel.
Gestion des secrets
- Node.js
- Python
- Docker
Limites de débit et utilisation
Les limites de débit varient selon le forfait d’abonnement. Surveillez votre utilisation dans le tableau de bord Helius afin de ne pas dépasser les limites qui vous sont allouées.
Comprendre les limites de débit
- Requêtes par seconde : selon votre niveau d’abonnement
- Quota mensuel de requêtes : nombre total de requêtes autorisées par cycle de facturation
- Marge pour les pics : pics de courte durée au-dessus de votre limite de débit de base
Gérer les limites de débit
Résolution des problèmes
Invalid API Key Error
Invalid API Key Error
Symptômes : erreurs 401 Unauthorized ou « Invalid API Key »Solutions :
- Vérifiez que votre clé API est correcte et qu’elle n’a pas été régénérée
- Vérifiez que vous incluez la clé API en tant que paramètre de requête :
?api-key=YOUR_KEY - Assurez-vous que votre clé API ne contient aucun espace ou caractère supplémentaire
- Vérifiez que votre clé API n’a pas expiré ou été révoquée
Rate Limit Exceeded
Rate Limit Exceeded
Symptômes : erreurs 429 Too Many RequestsSolutions :
- Vérifiez votre utilisation actuelle dans le tableau de bord
- Implémentez un délai exponentiel dans votre logique de nouvelle tentative
- Envisagez de passer à un forfait supérieur pour bénéficier de limites plus élevées
- Optimisez vos requêtes afin de réduire les appels inutiles
Forbidden Access
Forbidden Access
Symptômes : erreurs 403 ForbiddenSolutions :
- Vérifiez que les restrictions d’adresses IP ne bloquent pas vos requêtes
- Vérifiez que votre abonnement inclut l’accès au point de terminaison
- Assurez-vous que votre clé API dispose des autorisations nécessaires
Étapes suivantes
Quickstart Guide
Effectuez vos premiers appels API avec Helius
API Reference
Explorez tous les points de terminaison et toutes les méthodes disponibles
Rate Limits
Découvrez les limites de débit et les options de mise à niveau
Dashboard
Surveillez votre utilisation de l’API et gérez vos clés
Assistance
Besoin d’aide avec l’authentification ou des questions sur les clés API ?Discord Community
Rejoignez notre serveur Discord pour obtenir de l’aide en temps réel et bénéficier du soutien de la communauté
Email Support
Contactez directement notre équipe d’assistance