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)

Ignorez cette étape si vous payez via le lien de paiement hébergé (mode d’inscription par défaut, finalisé avec helius 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

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

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