Skip to main content

​
Was das bedeutet

401 Unauthorized – Deinem request fehlen gültige Anmeldedaten.

​
Häufige Ursachen

  • Ungültiger oder fehlender API key
  • API key befindet sich an der falschen Stelle
  • Zugriffskontrollregeln blockieren deinen request
  • Abgelaufener oder widerrufener API key

​
Lösungen

  1. Prüfe das Format deines API key
  2. Prüfe die Position des API key
    • Stelle sicher, dass sich der API key in den Abfrageparametern befindet
    • Prüfe, ob zusätzliche Leerzeichen oder Zeichen vorhanden sind
  3. Prüfe die Zugriffskontrollregeln
    • Prüfe deine Dashboard-Einstellungen auf IP-Beschränkungen
    • Stelle bei Browser-requests sicher, dass deine Domain auf der Positivliste steht
Eine ausführliche Anleitung zur Einrichtung der Authentifizierung findest du unter Authentifizierung.

​
Was das bedeutet

429 Too Many Requests – Du hast die rate limits deines Tarifs überschritten.

​
Häufige Ursachen

  • Du sendest requests schneller, als dein Tarif erlaubt
  • Lastspitzen überschreiten die momentanen Grenzwerte
  • Mehrere Anwendungen verwenden denselben API key
  • Ineffizienter Code sendet redundante requests

​
Lösungen

  1. Überwache deine Nutzung
    • Prüfe das Diagramm Rate Limited Requests in deinem Dashboard
    • Prüfe, welche endpoints die Grenzwerte erreichen
  2. Optimiere deine requests
    • Speichere responses nach Möglichkeit im Cache
    • Fasse mehrere Vorgänge in einzelnen Aufrufen zusammen
    • Entferne unnötiges Polling oder doppelte requests
  3. Implementiere rate limiting
    • Füge in deiner Anwendung Verzögerungen zwischen requests ein
    • Verwende exponentielles Backoff für Wiederholungsversuche
  4. Erwäge ein Upgrade
Rate limits werden jede Minute zurückgesetzt. Eine vorübergehende Drosselung ist daher meist schnell behoben.

​
Was das bedeutet

500 Internal Server Error – Bei der Verarbeitung deines request ist ein serverseitiger Fehler aufgetreten.

​
Häufige Ursachen

  • Fehlerhaftes request payload
  • Vorübergehende Serverprobleme
  • Ungültige Parameter verursachen Serverfehler
  • Probleme mit der Netzwerkverbindung

​
Lösungen

  1. Validiere deinen request
    • Stelle sicher, dass das JSON payload korrekt formatiert ist
    • Prüfe, ob alle erforderlichen Parameter enthalten sind
    • Prüfe, ob die Parametertypen der API-Spezifikation entsprechen
  2. Prüfe den Dienststatus
    • Auf der Helius-Statusseite findest du aktuelle Störungen
    • Suche nach gemeldeten Ausfällen oder Leistungseinbußen
  3. Implementiere eine Wiederholungslogik
    • Warte einige Sekunden, bevor du es erneut versuchst
    • Verwende exponentielles Backoff für mehrere Versuche
  4. Wende dich an den Support
    • Wenn die Fehler weiterhin auftreten, kontaktiere den Support und gib die Details deines request an
    • Füge das genaue request payload und den Zeitstempel hinzu
Serverfehler sind normalerweise vorübergehend und werden meist automatisch behoben.

​
Was das bedeutet

503 Service Unavailable – Der Server ist vorübergehend überlastet oder wird gewartet.

​
Häufige Ursachen

  • Hohes Datenverkehrsaufkommen führt zu einer vorübergehenden Überlastung
  • Geplante Wartungsfenster
  • Die Kapazitätsgrenzen des Servers wurden erreicht
  • Probleme mit der Netzwerkinfrastruktur

​
Lösungen

  1. Warte und versuche es erneut
    • Warte 30–60 Sekunden, bevor du es erneut versuchst
    • Dieser Fehler verschwindet normalerweise, sobald sich die Last ausgleicht
  2. Implementiere intelligente Wiederholungsversuche
    • Verwende exponentielles Backoff (beginne mit 1 s, dann 2 s, 4 s usw.)
    • Lege eine maximale Anzahl von Wiederholungsversuchen fest (3–5 Versuche)
    • Füge Jitter hinzu, um einen Thundering-Herd-Effekt zu vermeiden
  3. Prüfe, ob Wartungsarbeiten stattfinden
    • Prüfe die Helius-Statusseite auf geplante Wartungsarbeiten
    • Plane unter Berücksichtigung angekündigter Wartungsfenster
  4. Verteile die Last
    • Verteile requests nach Möglichkeit über einen längeren Zeitraum
    • Vermeide Lastspitzen, die den Überlastungsschutz auslösen können
503-Fehler sind nur vorübergehend. Der Dienst wird automatisch wiederhergestellt, sobald die Serverlast sinkt.

​
Was das bedeutet

504 Gateway Timeout – Der Server hat innerhalb des timeout keine response von vorgelagerten Diensten erhalten.

​
Häufige Ursachen

  • Probleme mit der Netzwerkverbindung
  • Komplexe Vorgänge überschreiten die timeout-Grenzwerte
  • Langsame Blockchain-responses bei hoher Netzwerkauslastung
  • Die Verarbeitung großer Daten-requests dauert zu lange

​
Lösungen

  1. Prüfe deine Verbindung
    • Prüfe, ob deine Internetverbindung stabil ist
    • Sende einen einfachen request, um lokale Probleme auszuschließen
  2. Optimiere große requests
    • Teile große Batch-requests in kleinere Einheiten auf
    • Verwende Paginierung für datenintensive Abfragen
    • Erwäge WebSocket-Verbindungen für Echtzeitdaten
  3. Implementiere timeouts
    • Lege in deinem Clientcode geeignete timeout-Werte fest (30–60 Sekunden)
    • Behandle timeout-Fehler ordnungsgemäß mit Wiederholungsversuchen
  4. Überwache den Dienststatus
    • Prüfe die Helius-Statusseite auf Netzwerkprobleme
    • Suche nach Meldungen über eine hohe Blockchain-Auslastung
Gateway-timeouts deuten häufig auf eine hohe Netzwerkauslastung oder komplexe Vorgänge hin. Teile große requests nach Möglichkeit in kleinere Einheiten auf.

​
Brauchst du weitere Hilfe?

Contact Support

Unser Team hilft dir über Discord, Chat oder E-Mail-Support weiter.

Status Page

Prüfe die Dienstverfügbarkeit und Leistungsinformationen in Echtzeit.