Skip to main content

​
Ce que cela signifie

401 Non autorisé - Votre requête ne contient pas d’informations d’authentification valides.

​
Causes courantes

  • Clé API invalide ou manquante
  • Clé API incluse au mauvais endroit
  • Règles de contrôle d’accès bloquant votre requête
  • Clé API expirée ou révoquée

​
Solutions

  1. Vérifiez le format de votre clé API
  2. Vérifiez l’emplacement de la clé API
    • Assurez-vous que la clé API est dans les paramètres de requête
    • Vérifiez qu’il n’y ait pas d’espaces ou de caractères supplémentaires
  3. Vérifiez les règles de contrôle d’accès
    • Vérifiez vos paramètres du tableau de bord pour les restrictions IP
    • Assurez-vous que votre domaine est autorisé si vous utilisez des requêtes de navigateur
Pour une configuration d’authentification détaillée, consultez notre guide Authentication.

​
Ce que cela signifie

429 Trop de requêtes - Vous avez dépassé les limites de votre plan.

​
Causes courantes

  • Effectuer des requêtes plus rapidement que ne le permet votre plan
  • Trafic en rafale dépassant les limites instantanées
  • Plusieurs applications partageant la même clé API
  • Code inefficace effectuant des requêtes redondantes

​
Solutions

  1. Surveillez votre utilisation
    • Consultez le graphique Rate Limited Requests dans votre tableau de bord
    • Examinez quels endpoints atteignent des limites
  2. Optimisez vos requêtes
    • Mettez les réponses en cache lorsque c’est possible
    • Regroupez plusieurs opérations en appels uniques
    • Éliminez les sondages inutiles ou les requêtes en double
  3. Mettez en œuvre la limitation de débit
    • Ajoutez des délais entre les requêtes dans votre application
    • Utilisez une backoff exponentielle pour les nouvelles tentatives
  4. Envisagez de passer à un plan supérieur
Les limites de débit se réinitialisent chaque minute, donc les limitations temporaires se résolvent généralement rapidement.

​
Ce que cela signifie

500 Erreur interne du serveur - Une erreur côté serveur s’est produite lors du traitement de votre requête.

​
Causes courantes

  • Charge utile de la requête mal formée
  • Serveur rencontrant des problèmes temporaires
  • Paramètres invalides entraînant des erreurs de serveur
  • Problèmes de connectivité réseau

​
Solutions

  1. Validez votre requête
    • Assurez-vous que la charge utile JSON est correctement formatée
    • Vérifiez que tous les paramètres requis sont inclus
    • Vérifiez que les types de paramètres correspondent à la spécification de l’API
  2. Vérifiez le statut du service
    • Visitez la Page de statut Helius pour les problèmes en cours
    • Recherchez toute panne signalée ou dégradation des performances
  3. Mettez en œuvre une logique de nouvelle tentative
    • Attendez quelques secondes avant de réessayer
    • Utilisez une backoff exponentielle pour plusieurs tentatives
  4. Obtenez de l’aide
    • Si les erreurs persistent, contactez le support avec les détails de votre requête
    • Incluez la charge utile exacte de la requête et l’horodatage
Les erreurs serveur sont généralement temporaires et se résolvent automatiquement.

​
Ce que cela signifie

503 Service Indisponible - Le serveur est temporairement surchargé ou en maintenance.

​
Causes courantes

  • Trafic élevé entraînant une surcharge temporaire
  • Fenêtres de maintenance programmées
  • Limites de capacité du serveur atteintes
  • Problèmes d’infrastructure réseau

​
Solutions

  1. Attendez et réessayez
    • Attendez 30-60 secondes avant de réessayer
    • Cette erreur se résout généralement à mesure que la charge s’équilibre
  2. Mettez en œuvre des nouvelles tentatives intelligentes
    • Utilisez une backoff exponentielle (commencez par 1s, puis 2s, 4s, etc.)
    • Définissez une limite maximale de nouvelles tentatives (3-5 tentatives)
    • Ajoutez du jitter pour éviter les effets de troupeau
  3. Vérifiez la maintenance
    • Consultez la Page de statut Helius pour les maintenances programmées
    • Planifiez autour des fenêtres de maintenance annoncées
  4. Répartissez la charge
    • Si possible, étalez les requêtes dans le temps
    • Évitez les modèles en rafale qui peuvent déclencher la protection contre la surcharge
Les erreurs 503 sont conçues pour être temporaires - le service se rétablit automatiquement à mesure que la charge du serveur diminue.

​
Ce que cela signifie

504 Délai d’attente de la passerelle - Le serveur n’a pas reçu de réponse des services en amont dans le délai imparti.

​
Causes courantes

  • Problèmes de connectivité réseau
  • Opérations complexes dépassant les limites de délai
  • Réponses lentes de la blockchain lors de forte congestion du réseau
  • Grandes requêtes de données prenant trop de temps à traiter

​
Solutions

  1. Vérifiez votre connexion
    • Assurez-vous que votre connexion Internet est stable
    • Testez avec une requête simple pour écarter les problèmes locaux
  2. Optimisez les grandes requêtes
    • Divisez les grandes requêtes en lots en plus petits morceaux
    • Utilisez la pagination pour les requêtes lourdes en données
    • Envisagez d’utiliser des connexions WebSocket pour les données en temps réel
  3. Mettez en œuvre des délais
    • Définissez des valeurs de délai appropriées dans votre code client (30-60 secondes)
    • Gérez les erreurs de délai avec élégance en utilisant des nouvelles tentatives
  4. Surveillez le statut du service
    • Vérifiez la Page de statut Helius pour les problèmes de réseau
    • Recherchez des rapports de forte congestion de la blockchain
Les délais d’attente de la passerelle indiquent souvent une congestion du réseau ou des opérations complexes. Envisagez de diviser les grandes requêtes en plus petites parties.

​
Besoin de plus d’aide ?

Contacter le support

Obtenez de l’aide de notre équipe via Discord, chat ou support par email.

Page de statut

Vérifiez la disponibilité et les informations de performance du service en temps réel.