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

# Fehlercodes FAQ

> Beheben Sie HTTP-Fehlercodes bei der Verwendung von Helius RPC-Endpunkten – identifizieren und beheben Sie die häufigsten Authentifizierungs-, Ratenbegrenzungs- und Serverprobleme

<AccordionGroup>
  <Accordion title="Warum erhalte ich einen 401-Fehler?">
    ## Was das bedeutet

    <Warning>**401 Unauthorized** – Ihre Anfrage enthält keine gültigen Authentifizierungsdaten.</Warning>

    ## Häufige Ursachen

    * Ungültiger oder fehlender API-Schlüssel
    * API-Schlüssel an der falschen Stelle eingefügt
    * Zugriffssteuerungsregeln blockieren Ihre Anfrage
    * Abgelaufener oder widerrufener API-Schlüssel

    ## Lösungen

    1. **Überprüfen Sie das Format Ihres API-Schlüssels**

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

    2. **Überprüfen Sie die Platzierung des API-Schlüssels**
       * Stellen Sie sicher, dass sich der API-Schlüssel in den Abfrageparametern befindet
       * Überprüfen Sie, dass keine zusätzlichen Leerzeichen oder Zeichen vorhanden sind

    3. **Überprüfen Sie die Zugriffssteuerungsregeln**
       * Überprüfen Sie Ihre [Dashboard-Einstellungen](https://dashboard.helius.dev/) auf IP-Beschränkungen
       * Stellen Sie sicher, dass Ihre Domain auf die Allowlist gesetzt ist, wenn Sie Browseranfragen verwenden

    <Info>Für eine detaillierte Authentifizierungseinrichtung lesen Sie unseren [Authentifizierungsleitfaden](/docs/de/api-reference/authentication).</Info>
  </Accordion>

  <Accordion title="Warum erhalte ich einen 429-Fehler?">
    ## Was das bedeutet

    <Warning>**429 Too Many Requests** – Sie haben die Ratenbegrenzungen Ihres Plans überschritten.</Warning>

    ## Häufige Ursachen

    * Anfragen schneller als Ihr Plan es erlaubt
    * Stoßverkehr, der sofortige Begrenzungen überschreitet
    * Mehrere Anwendungen teilen denselben API-Schlüssel
    * Ineffizienter Code, der redundante Anfragen erstellt

    ## Lösungen

    1. **Überwachen Sie Ihre Nutzung**
       * Überprüfen Sie das `Rate Limited Requests`-Diagramm in Ihrem [Dashboard](https://dashboard.helius.dev/usage)
       * Überprüfen Sie, welche Endpunkte die Grenzen erreichen

    2. **Optimieren Sie Ihre Anfragen**
       * Antworten zwischenspeichern, wenn möglich
       * Mehrere Operationen in einzelne Anrufe zusammenfassen
       * Entfernen Sie unnötiges Polling oder doppelte Anfragen

    3. **Implementieren Sie Ratenbegrenzung**
       * Fügen Sie Verzögerungen zwischen den Anfragen in Ihrer Anwendung hinzu
       * Verwenden Sie Exponential Backoff für Wiederholungen

    4. **Erwägen Sie ein Upgrade**
       * Überprüfen Sie [Pläne & Ratenbegrenzungen](/docs/de/billing/plans) für höhere Stufen

    <Tip>Rate Limits werden jede Minute zurückgesetzt, daher wird temporäres Throttling normalerweise schnell behoben.</Tip>
  </Accordion>

  <Accordion title="Warum erhalte ich einen 500-Fehler?">
    ## Was das bedeutet

    <Warning>**500 Internal Server Error** – Ein serverseitiger Fehler ist beim Verarbeiten Ihrer Anfrage aufgetreten.</Warning>

    ## Häufige Ursachen

    * Fehlgebildetes Anforderungs-Payload
    * Server hat vorübergehende Probleme
    * Ungültige Parameter verursachen Serverfehler
    * Netzwerkverbindungsprobleme

    ## Lösungen

    1. **Validieren Sie Ihre Anfrage**
       * Stellen Sie sicher, dass das JSON-Payload ordnungsgemäß formatiert ist
       * Überprüfen Sie, dass alle erforderlichen Parameter enthalten sind
       * Überprüfen Sie, dass die Parametertypen mit der API-Spezifikation übereinstimmen

    2. **Überprüfen Sie den Dienststatus**
       * Besuchen Sie die [Helius Status Page](https://helius.statuspage.io/) für aktuelle Probleme
       * Überprüfen Sie, ob Ausfälle oder Leistungsabfälle gemeldet werden

    3. **Implementieren Sie Retry-Logik**
       * Warten Sie ein paar Sekunden, bevor Sie erneut versuchen
       * Verwenden Sie Exponential Backoff für mehrere Versuche

    4. **Holen Sie sich Unterstützung**
       * Wenn Fehler weiterhin bestehen, kontaktieren Sie den Support mit Ihren Anfragedetails
       * Geben Sie das exakte Anforderungs-Payload und den Zeitstempel an

    <Note>Serverfehler sind typischerweise vorübergehend und lösen sich normalerweise automatisch.</Note>
  </Accordion>

  <Accordion title="Warum erhalte ich einen 503-Fehler?">
    ## Was das bedeutet

    <Warning>**503 Service Unavailable** – Der Server ist vorübergehend überlastet oder in Wartung.</Warning>

    ## Häufige Ursachen

    * Hoher Verkehr verursacht vorübergehende Überlastung
    * Geplante Wartungsfenster
    * Serverkapazitätsgrenzen erreicht
    * Netzwerk-Infrastrukturprobleme

    ## Lösungen

    1. **Warten und erneut versuchen**
       * Warten Sie 30-60 Sekunden, bevor Sie es erneut versuchen
       * Dieser Fehler wird in der Regel behoben, sobald die Last ausgeglichen ist

    2. **Implementieren Sie intelligente Wiederholungen**
       * Verwenden Sie Exponential Backoff (beginnen Sie mit 1s, dann 2s, 4s, usw.)
       * Setzen Sie ein maximales Wiederholungslimit (3-5 Versuche)
       * Fügen Sie Jitter hinzu, um Herdeneffekte zu vermeiden

    3. **Überprüfen Sie auf Wartung**
       * Überprüfen Sie die [Helius Status Page](https://helius.statuspage.io/) auf geplante Wartung
       * Planen Sie um angekündigte Wartungsfenster herum

    4. **Verteilen Sie die Last**
       * Wenn möglich, verteilen Sie Anfragen über die Zeit
       * Vermeiden Sie Burst-Muster, die einen Überlastungsschutz auslösen können

    <Tip>503-Fehler sind dazu gedacht, vorübergehend zu sein – der Dienst erholt sich automatisch, wenn die Serverlast abnimmt.</Tip>
  </Accordion>

  <Accordion title="Warum erhalte ich einen 504-Fehler?">
    ## Was das bedeutet

    <Warning>**504 Gateway Timeout** – Der Server hat innerhalb der Timeout-Periode keine Antwort von den Upstream-Diensten erhalten.</Warning>

    ## Häufige Ursachen

    * Netzwerkverbindungsprobleme
    * Komplexe Operationen, die Timeout-Grenzen überschreiten
    * Langsame Blockchain-Antworten bei hoher Netzwerküberlastung
    * Große Datenanforderungen, die zu lange zum Verarbeiten benötigen

    ## Lösungen

    1. **Überprüfen Sie Ihre Verbindung**
       * Stellen Sie sicher, dass Ihre Internetverbindung stabil ist
       * Testen Sie mit einer einfachen Anfrage, um lokale Probleme auszuschließen

    2. **Optimieren Sie große Anfragen**
       * Teilen Sie große Batch-Anfragen in kleinere Teile auf
       * Verwenden Sie Pagination für datenintensive Abfragen
       * Erwägen Sie die Verwendung von WebSocket-Verbindungen für Echtzeitdaten

    3. **Implementieren Sie Timeouts**
       * Setzen Sie angemessene Timeout-Werte in Ihrem Client-Code (30-60 Sekunden)
       * Behandeln Sie Timeout-Fehler mit Wiederholungen

    4. **Überwachen Sie den Dienststatus**
       * Überprüfen Sie die [Helius Status Page](https://helius.statuspage.io/) auf Netzwerkprobleme
       * Suchen Sie nach Berichten über hohe Blockchain-Überlastung

    <Note>Gateway-Timeouts weisen oft auf Netzwerküberlastung oder komplexe Operationen hin. Erwägen Sie, große Anfragen in kleinere Teile zu unterteilen.</Note>
  </Accordion>
</AccordionGroup>

## Brauchen Sie mehr Hilfe?

<CardGroup cols={2}>
  <Card title="Kontaktieren Sie den Support" icon="headset" href="/docs/de/support/contact-support">
    Holen Sie sich Hilfe von unserem Team über Discord, Chat oder E-Mail-Support.
  </Card>

  <Card title="Statusseite" icon="wave-pulse" href="/docs/de/support/status-page">
    Überprüfen Sie die Verfügbarkeit und Leistungsinformationen von Diensten in Echtzeit.
  </Card>
</CardGroup>
