Skip to main content

​
Was das bedeutet

401 Unauthorized – Ihre Anfrage enthält keine gültigen Authentifizierungsdaten.

​
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
  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 auf IP-Beschränkungen
    • Stellen Sie sicher, dass Ihre Domain auf die Allowlist gesetzt ist, wenn Sie Browseranfragen verwenden
Für eine detaillierte Authentifizierungseinrichtung lesen Sie unseren Authentifizierungsleitfaden.

​
Was das bedeutet

429 Too Many Requests – Sie haben die Ratenbegrenzungen Ihres Plans überschritten.

​
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
    • Ü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
Rate Limits werden jede Minute zurückgesetzt, daher wird temporäres Throttling normalerweise schnell behoben.

​
Was das bedeutet

500 Internal Server Error – Ein serverseitiger Fehler ist beim Verarbeiten Ihrer Anfrage aufgetreten.

​
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 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
Serverfehler sind typischerweise vorübergehend und lösen sich normalerweise automatisch.

​
Was das bedeutet

503 Service Unavailable – Der Server ist vorübergehend überlastet oder in Wartung.

​
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 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
503-Fehler sind dazu gedacht, vorübergehend zu sein – der Dienst erholt sich automatisch, wenn die Serverlast abnimmt.

​
Was das bedeutet

504 Gateway Timeout – Der Server hat innerhalb der Timeout-Periode keine Antwort von den Upstream-Diensten erhalten.

​
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 auf Netzwerkprobleme
    • Suchen Sie nach Berichten über hohe Blockchain-Überlastung
Gateway-Timeouts weisen oft auf Netzwerküberlastung oder komplexe Operationen hin. Erwägen Sie, große Anfragen in kleinere Teile zu unterteilen.

​
Brauchen Sie mehr Hilfe?

Kontaktieren Sie den Support

Holen Sie sich Hilfe von unserem Team über Discord, Chat oder E-Mail-Support.

Statusseite

Überprüfen Sie die Verfügbarkeit und Leistungsinformationen von Diensten in Echtzeit.