Skip to main content
Helius API verwendet API-Schlüssel zur Authentifizierung von Anfragen. Jede API-Anfrage muss Ihren API-Schlüssel enthalten, um Ihre Identität und Berechtigungen zu überprüfen.
Ihr API-Schlüssel ist eine vertrauliche Information, die Zugriff auf Ihr Helius-Konto gewährt. Geben Sie ihn niemals in clientseitigem Code, öffentlichen Repositories oder browserzugänglichen Bereichen preis.

Erste Schritte

1. Erstellen Sie Ihren API-Schlüssel

1

Registrieren oder Anmelden

Erstellen Sie ein Konto auf dem Helius Dashboard oder melden Sie sich bei Ihrem vorhandenen Konto an.
2

Navigieren Sie zu API-Schlüsseln

Gehen Sie zum Abschnitt API-Schlüssel in Ihrer Dashboard-Seitenleiste.
3

Erstellen Sie einen neuen Schlüssel

Klicken Sie auf Neuen API-Schlüssel erstellen und geben Sie einen beschreibenden Namen für Ihr Projekt an (z. B. “Produktions-App”, “Entwicklungsumgebung”).
4

Kopieren und sichern Sie Ihren Schlüssel

Kopieren Sie Ihren API-Schlüssel sofort und speichern Sie ihn sicher. Sie können ihn nicht mehr sehen, sobald Sie die Seite verlassen.

2. Verwendung Ihres API-Schlüssels

Fügen Sie Ihren API-Schlüssel als Abfrageparameter in alle Anfragen ein:

Erste Schritte (Für Agenten)

Agenten können programmgesteuert Helius-Konten registrieren, Projekte erstellen und API-Schlüssel mithilfe der Helius CLI generieren. Für vollständige Anweisungen lesen Sie: https://dashboard.helius.dev/agents.md

Installieren Sie die Helius CLI

Ein Schlüsselpaar generieren

Das generierte Wallet aufladen (nur Autopay)

Überspringen Sie diesen Schritt, wenn Sie über den gehosteten Zahlungslink bezahlen (der Standard-Anmeldemodus, abgeschlossen mit helius signup --resume). Autopay (--pay) zahlt aus dem lokalen Schlüsselpaar: Senden Sie 1 USDC und 0.001 SOL an die in Schritt 2 angegebene Wallet-Adresse.

Anmelden und API-Schlüssel erhalten

Sicherheitsbest Practices

Umgebungsvariablen

Speichern Sie Ihren API-Schlüssel in Umgebungsvariablen, nicht in Ihrem Quellcode.

IP-Einschränkungen

Richten Sie IP-Einschränkungen für Ihre API-Schlüssel im Dashboard ein, um den Zugriff auf bestimmte IP-Adressen oder Bereiche zu beschränken.

Separate Schlüssel

Verwenden Sie unterschiedliche API-Schlüssel für Entwicklungs-, Staging- und Produktionsumgebungen, um die Nutzung zu isolieren und die Sicherheit zu erhöhen.

Nutzung überwachen

Überprüfen Sie regelmäßig Ihre API-Nutzung im Dashboard, um ungewöhnliche Muster oder potenzielle Sicherheitsprobleme zu erkennen.

Verwaltungsgeheimnisse

Ratenbegrenzungen & Nutzung

Ratenbegrenzungen variieren je nach Abonnementplan. Überwachen Sie Ihre Nutzung im Helius Dashboard, um sicherzustellen, dass Sie innerhalb Ihrer zugewiesenen Grenzen bleiben.

Verständnis der Ratenbegrenzungen

  • Anfragen pro Sekunde: Basierend auf Ihrem Abonnementlevel
  • Monatliches Anfragenkontingent: Gesamtzahl der Anfragen pro Abrechnungszyklus
  • Spitzenzulage: Kurzfristige Anstiege über Ihr Basiskontingent hinaus

Umgang mit Ratenbegrenzungen

Fehlerbehebung

Symptome: 401 Unauthorized oder “Invalid API Key”-FehlerLösungen:
  • Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist und nicht neu generiert wurde
  • Stellen Sie sicher, dass Sie den API-Schlüssel als Abfrageparameter einschließen: ?api-key=YOUR_KEY
  • Stellen Sie sicher, dass keine zusätzlichen Leerzeichen oder Zeichen in Ihrem API-Schlüssel vorhanden sind
  • Bestätigen Sie, dass Ihr API-Schlüssel nicht abgelaufen oder widerrufen wurde
Symptome: 429 Zu viele Anfragen-FehlerLösungen:
  • Überprüfen Sie Ihre aktuelle Nutzung im Dashboard
  • Implementieren Sie exponentielles Backoff in Ihrer Wiederholungslogik
  • Erwägen Sie ein Upgrade Ihres Plans für höhere Limits
  • Optimieren Sie Ihre Anfragen, um unnötige Anrufe zu reduzieren
Symptome: 403 Verbotene-FehlerLösungen:
  • Überprüfen Sie, ob IP-Einschränkungen Ihre Anfragen blockieren
  • Stellen Sie sicher, dass Ihr Abonnement Zugang zum Endpunkt enthält
  • Stellen Sie sicher, dass Ihr API-Schlüssel die erforderlichen Berechtigungen hat

Nächste Schritte

Schnellstartanleitung

Beginnen Sie mit Ihren ersten API-Anfragen mit Helius

API-Referenz

Erforschen Sie alle verfügbaren Endpunkte und Methoden

Ratenbegrenzungen

Verstehen Sie Ratenbegrenzungen und Upgrade-Optionen

Dashboard

Überwachen Sie Ihre API-Nutzung und verwalten Sie Schlüssel

Unterstützung

Brauchen Sie Hilfe bei der Authentifizierung oder haben Sie Fragen zu API-Schlüsseln?

Discord-Community

Treten Sie unserem Discord bei für Hilfe in Echtzeit und Community-Support

E-Mail-Support

Kontaktieren Sie unser Support-Team direkt