> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ sur les codes d'erreur

> Dépannez les codes d'erreur HTTP lors de l'utilisation des endpoints Helius RPC - identifiez et résolvez les problèmes d'authentification, de limitation de débit et de serveur les plus courants

<AccordionGroup>
  <Accordion title="Pourquoi est-ce que je reçois une erreur 401 ?">
    ## Ce que cela signifie

    <Warning>**401 Non autorisé** - Votre requête ne contient pas d'informations d'authentification valides.</Warning>

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

       ```
       https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
       ```

    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](https://dashboard.helius.dev/) pour les restrictions IP
       * Assurez-vous que votre domaine est autorisé si vous utilisez des requêtes de navigateur

    <Info>Pour une configuration d'authentification détaillée, consultez notre guide [Authentication](/docs/fr/api-reference/authentication).</Info>
  </Accordion>

  <Accordion title="Pourquoi est-ce que je reçois une erreur 429 ?">
    ## Ce que cela signifie

    <Warning>**429 Trop de requêtes** - Vous avez dépassé les limites de votre plan.</Warning>

    ## 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](https://dashboard.helius.dev/usage)
       * 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**
       * Consultez [Plans et limites de débit](/docs/fr/billing/plans) pour des niveaux supérieurs

    <Tip>Les limites de débit se réinitialisent chaque minute, donc les limitations temporaires se résolvent généralement rapidement.</Tip>
  </Accordion>

  <Accordion title="Pourquoi est-ce que je reçois une erreur 500 ?">
    ## Ce que cela signifie

    <Warning>**500 Erreur interne du serveur** - Une erreur côté serveur s'est produite lors du traitement de votre requête.</Warning>

    ## 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](https://helius.statuspage.io/) 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

    <Note>Les erreurs serveur sont généralement temporaires et se résolvent automatiquement.</Note>
  </Accordion>

  <Accordion title="Pourquoi est-ce que je reçois une erreur 503 ?">
    ## Ce que cela signifie

    <Warning>**503 Service Indisponible** - Le serveur est temporairement surchargé ou en maintenance.</Warning>

    ## 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](https://helius.statuspage.io/) 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

    <Tip>Les erreurs 503 sont conçues pour être temporaires - le service se rétablit automatiquement à mesure que la charge du serveur diminue.</Tip>
  </Accordion>

  <Accordion title="Pourquoi est-ce que je reçois une erreur 504 ?">
    ## Ce que cela signifie

    <Warning>**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.</Warning>

    ## 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](https://helius.statuspage.io/) pour les problèmes de réseau
       * Recherchez des rapports de forte congestion de la blockchain

    <Note>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.</Note>
  </Accordion>
</AccordionGroup>

## Besoin de plus d'aide ?

<CardGroup cols={2}>
  <Card title="Contacter le support" icon="headset" href="/docs/fr/support/contact-support">
    Obtenez de l'aide de notre équipe via Discord, chat ou support par email.
  </Card>

  <Card title="Page de statut" icon="wave-pulse" href="/docs/fr/support/status-page">
    Vérifiez la disponibilité et les informations de performance du service en temps réel.
  </Card>
</CardGroup>
