Skip to main content

​
Credits und Rate Limits

Bis zu 100.000 Adressen unter Verwendung der API.
Ja, das Bearbeiten eines Webhooks über die API oder das Dashboard kostet 100 Credits pro Anfrage. Dies gilt für jede Änderung, einschließlich URL-Änderungen, Hinzufügen/Entfernen von Adressen oder Aktualisieren von Transaktionstypen.
Jedes Webhook-Ereignis kostet 1 Credit, wenn Helius das Ereignis verarbeitet und an Ihren Endpunkt sendet. Es wird berechnet, unabhängig davon, ob Ihr Endpunkt den Webhook erfolgreich verarbeitet oder einen Fehler zurückgibt.
Alle Verwaltungsoperationen (erstellen, bearbeiten, löschen) kosten 100 Credits pro Anfrage, wenn sie über die API durchgeführt werden. Dies deckt die Verarbeitung ab, die erforderlich ist, um Ihre Webhook-Konfigurationen zu aktualisieren.

​
Unterstützte Netzwerke

Ja. Wenn Sie einen Webhook über die Benutzeroberfläche erstellen, wählen Sie „devnet“ als „Netzwerk“. Wenn Sie ihn über die Webhook-API erstellen, setzen Sie den Parameter „webhookType“ auf “rawDevnet”, “enhancedDevnet” oder „discordDevnet“ je nach gewünschtem Webhook-Typ.
Nein — die URL muss öffentlich über HTTPS erreichbar sein. Helius kann nicht auf lokale Entwicklungsserver über localhost-URLs zugreifen.

​
Verwendung von Webhooks

Setzen Sie einen Autorisierungsheader beim Erstellen oder Aktualisieren des Webhooks. Helius spiegelt diesen Wert im Authorization-Header wider, wenn Daten an Ihren Webhook-Endpunkt gesendet werden, sodass Sie die Authentizität der Anfrage überprüfen können.
Raw Webhooks liefern reguläre Solana-Transaktionsdaten direkt von der Blockchain. Wenn eine Transaktion für die überwachten Adressen erfolgt, werden die Rohdaten der Transaktion an Ihre Webhook-URL gesendet.Enhanced Webhooks bieten von Helius interpretierte Transaktionstypen. Wir analysieren über 100 Arten von Solana-Transaktionen (NFT-Listings, DeFi-Swaps, Überweisungen usw.) und abstrahieren sie in unser eigenes Schema.Verwenden Sie Raw Webhooks, wenn Sie alle Transaktionsdaten ohne Abstraktionen möchten, oder Enhanced Webhooks, wenn Sie eine eingebaute Erkennung und Verarbeitung von Transaktionstypen wünschen.
Webhooks senden Benachrichtigungen unmittelbar nachdem eine passende Transaktion auf der Blockchain bestätigt wurde.

​
Wiederholungsversuche

Ihr Endpunkt muss innerhalb von 1 Sekunde einen 200-Statuscode zurückgeben, um den erfolgreichen Empfang zu bestätigen. Als bewährte Methode antworten Sie sofort mit 200 und bearbeiten Sie alle Verarbeitungsvorgänge asynchron — dies verhindert Zeitüberschreitungen, die durch langsame Geschäftsvorgänge verursacht werden.
Helius wiederholt die Zustellung, wenn Ihr Endpunkt einen 5xx-Fehler, einen 4xx-Fehler (außer 403), eine Zeitüberschreitung oder einen Verbindungsfehler oder DNS-Ausfall zurückgibt. Wir versuchen bis zu 3 Mal mit einer 1-Sekunden-Lücke zwischen jedem Versuch erneut.Wenn alle Wiederholungsversuche fehlschlagen, geht das Ereignis dauerhaft verloren — es gibt keine erneute Warteschleife oder zweiten Zustellungszyklus.Überwachen Sie Ihre Webhook-Protokolle im Helius Dashboard, um Zustellungsfehler zu identifizieren und Endpunktprobleme zu untersuchen.Wir bieten auch anpassbare Wiederholungspolitiken für Unternehmenspläne an.
Helius kann dasselbe Webhook-Ereignis mehrmals liefern. Dies kann aufgrund der Wiederholungslogik oder Netzwerkproblemen passieren.Ihr Webhook-Handler muss auf Duplikate vorbereitet sein — das mehrfache Verarbeiten desselben Ereignisses sollte das gleiche Ergebnis liefern wie das einmalige Verarbeiten.Um Duplikate zu handhaben, verwenden Sie die Transaktionssignatur oder einen eindeutigen Ereignisidentifikator, um zu verfolgen, welche Ereignisse Sie bereits verarbeitet haben.
Es hängt vom Webhook-Typ ab. Enhanced Webhooks senden keine fehlgeschlagenen Transaktionen, aber Raw Webhooks enthalten sowohl erfolgreiche als auch fehlgeschlagene Transaktionen.

​
Automatisches Deaktivieren

Helius überwacht die Gesundheit des Endpunkts und deaktiviert Webhooks automatisch bei einer ≥ 95% Zustellungsfehlerquote. Bezahlte Pläne (Dev und höher) werden über ein 7-Tage-Fenster bewertet, während Free-Plan-Webhooks über ein 24-Stunden-Fenster bewertet werden. Dies verhindert verschwendete Zustellungsversuche an unerreichbare Endpunkte.Häufige Ursachen sind eine unerreichbare Endpunkt-URL, dass Ihr Server konsistente Fehlerantworten zurückgibt oder Netzwerk-/Firewallprobleme, die Helius-Zustellungen blockieren.
  1. Beheben Sie das zugrunde liegende Problem mit Ihrem Endpunkt.
  2. Melden Sie sich beim Helius Dashboard an.
  3. Finden Sie den deaktivierten Webhook und schalten Sie ihn wieder ein.
Sie können Webhooks auch programmgesteuert über den Toggle Webhook API-​Endpunkt durch Senden einer PATCH-Anfrage mit { "active": true } reaktivieren.
Nein. Nach der Reaktivierung tritt der Webhook in eine 24-Stunden-Karenzzeit ein, während der er nicht automatisch deaktiviert wird. Dies gibt Ihnen Zeit, zu überprüfen, ob Ihr Endpunkt gesund ist, bevor die nächste Bewertung erfolgt.
Ja — Benutzer auf dem Dev-Plan und höher erhalten eine E-Mail-Benachrichtigung, wenn ein Webhook automatisch deaktiviert wird. Benutzer des kostenlosen Plans können den Webhook-Status im Helius Dashboard überwachen.
Ja. Sie können Webhooks im Helius Dashboard oder über den Toggle Webhook API-Endpunkt ein- und ausschalten. Dies ermöglicht es Ihnen, Lieferungen vorübergehend zu pausieren, ohne Ihre Webhook-Konfiguration zu verlieren.

​
Fehlerbehebung bei Webhooks

Datenverlust tritt normalerweise auf, wenn Ihr Endpunkt auf einen Fehler stößt, was dazu führt, dass Webhook-Wiederholungen schließlich fehlschlagen und zu Datenverlust führen. Überprüfen Sie Ihre Webhook-Protokolle im Dashboard, stellen Sie sicher, dass ausreichende Client-seitige Protokollierung vorhanden ist, und kontaktieren Sie den Support, wenn das Problem weiterhin besteht.
Stellen Sie sicher, dass der ausgewählte Transaktionstyp mit den Transaktionen übereinstimmt, die Sie überwachen. Beginnen Sie mit dem Transaktionstyp „ANY“, um festzustellen, ob es sich um ein allgemeines Problem oder ein Typ-Mismatch handelt. Verwenden Sie webhook.site, um zu testen, ob das Problem in Ihrer Endpunkt-Konfiguration liegt.
Der TOKEN_MINT-Webhoook wird nur für bestimmte Programme wie Candy Machine V1 und Solana Program Library ausgelöst. Er deckt nicht alle Token-Minting-Ereignisse über die gesamte Blockchain ab. Für eine breitere Überwachung sollten Sie eine allgemeinere Konto- oder Programmanmeldung über Webhooks mit „ANY“-Transaktionstypfilterung in Betracht ziehen.

​
Brauchen Sie weitere Hilfe?

Kontaktieren Sie den Support

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

Statusseite

Überprüfen Sie die aktuelle Verfügbarkeit und Leistungsinformationen des Dienstes.