Skip to main content
L’API Helius utilise des clés API pour authentifier les requêtes. Chaque requête API doit inclure votre clé API pour vérifier votre identité et vos autorisations.
Votre clé API est une information sensible qui donne accès à votre compte Helius. Ne l’exposez jamais dans le code côté client, les dépôts publics ou les zones accessibles par le navigateur.

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.md

Installez le Helius CLI

Générez une Paire de Clés

Financez le Portefeuille Généré (Autopay uniquement)

Passez cette étape si vous payez via le lien de paiement hébergé (le mode d’inscription par défaut, finalisé avec helius signup --resume). Autopay (--pay) paie à partir de la paire de clés locale : envoyez 1 USDC et 0.001 SOL à l’adresse de portefeuille fournie à l’étape 2.

Inscription et Obtention de la Clé API

Meilleures Pratiques de Sécurité

Variables d'Environnement

Stockez votre clé API dans des variables d’environnement, pas dans votre code source.

Restrictions IP

Configurez les restrictions IP pour vos clés API dans le tableau de bord pour limiter l’accès à des adresses IP ou plages spécifiques.

Clés Séparées

Utilisez différentes clés API pour les environnements de développement, de mise en scène et de production pour isoler l’utilisation et améliorer la sécurité.

Surveiller l'Utilisation

Vérifiez régulièrement votre utilisation de l’API dans le tableau de bord pour détecter des modèles inhabituels ou des problèmes de sécurité potentiels.

Gestion des Secrets

Limites de Taux et Utilisation

Les limites de taux varient selon le plan d’abonnement. Surveillez votre utilisation dans le Tableau de bord Helius pour vous assurer de rester dans les limites allouées.

Comprendre les Limites de Taux

  • Requêtes par seconde : Basé sur votre niveau d’abonnement
  • Quota mensuel de requêtes : Total des requêtes autorisées par cycle de facturation
  • Tolérance de sursaut : Pics à court terme au-dessus de votre limite de taux de base

Gestion des Limites de Taux

Dépannage

Symptômes : 401 Non autorisé ou erreurs “Clé API invalide”Solutions :
  • Vérifiez que votre clé API est correcte et n’a pas été régénérée
  • Assurez-vous d’inclure la clé API en tant que paramètre de requête : ?api-key=YOUR_KEY
  • Assurez-vous qu’il n’y a pas d’espaces ou de caractères supplémentaires dans votre clé API
  • Confirmez que votre clé API n’a pas expiré ou n’a pas été révoquée
Symptômes : 429 Erreurs Trop de RequêtesSolutions :
  • Vérifiez votre utilisation actuelle dans le tableau de bord
  • Implémentez un backoff exponentiel dans votre logique de réessai
  • Envisagez de mettre à niveau votre plan pour des limites plus élevées
  • Optimisez vos requêtes pour réduire les appels inutiles
Symptômes : 403 Erreurs InterditesSolutions :
  • Vérifiez que les restrictions 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 a les autorisations nécessaires

Étapes Suivantes

Guide de Démarrage Rapide

Commencez à effectuer vos premiers appels API avec Helius

Référence API

Explorez tous les points de terminaison et méthodes disponibles

Limites de Taux

Comprenez les limites de taux et les options de mise à niveau

Tableau de Bord

Surveillez votre utilisation de l’API et gérez les clés

Support

Besoin d’aide avec l’authentification ou des questions sur les clés API ?

Communauté Discord

Rejoignez notre Discord pour obtenir de l’aide en temps réel et le support de la communauté

Support par Email

Contactez directement notre équipe de support