Credits und Rate Limits
How many addresses can I input for 1 webhook?
How many addresses can I input for 1 webhook?
Bis zu 100.000 Adressen über die API.
Will I be charged credits if I change the webhook URL in the Helius dashboard after creating the webhook?
Will I be charged credits if I change the webhook URL in the Helius dashboard after creating the webhook?
Ja. Das Bearbeiten eines Webhooks über die API oder das Dashboard kostet 100 Credits pro request. Dies gilt für jede Änderung, einschließlich URL-Änderungen, Hinzufügen oder Entfernen von Adressen und Aktualisieren von Transaktionstypen.
How many credits does it cost to receive a webhook notification?
How many credits does it cost to receive a webhook notification?
Jedes Webhook-Ereignis kostet 1 Credit, wenn Helius das Ereignis verarbeitet und an deinen endpoint sendet. Die Credits werden unabhängig davon berechnet, ob dein endpoint den Webhook erfolgreich verarbeitet oder einen Fehler zurückgibt.
How much does it cost to create, edit, and delete webhooks?
How much does it cost to create, edit, and delete webhooks?
Alle Vorgänge zur Verwaltung von Webhooks (Erstellen, Bearbeiten, Löschen) kosten 100 Credits pro request, wenn du sie über die API ausführst. Dies deckt die Verarbeitung ab, die zum Aktualisieren deiner Webhook-Konfigurationen erforderlich ist.
Unterstützte Netzwerke
Are webhooks available on Solana Devnet?
Are webhooks available on Solana Devnet?
Ja. Wenn du einen Webhook über die Benutzeroberfläche erstellst, wähle „devnet“ als „Netzwerk“. Wenn du ihn über die Webhook API erstellst, setze den Parameter „webhookType“ je nach gewünschtem Webhook-Typ auf “rawDevnet”, “enhancedDevnet” oder „discordDevnet“.
Can I input 'localhost' for my webhook URL?
Can I input 'localhost' for my webhook URL?
Nein – die URL muss öffentlich über HTTPS erreichbar sein. Helius kann über localhost-URLs nicht auf lokale Entwicklungsserver zugreifen.
Webhooks verwenden
How can I verify that the webhook came from Helius?
How can I verify that the webhook came from Helius?
Lege beim Erstellen oder Aktualisieren des Webhooks einen Autorisierungs-Header fest. Helius gibt diesen Wert beim Senden von Daten an deinen Webhook-endpoint im Header
Authorization zurück. So kannst du die Authentizität des requests überprüfen.What is the difference between 'raw' and 'enhanced' webhooks?
What is the difference between 'raw' and 'enhanced' webhooks?
Raw Webhooks geben reguläre Solana-Transaktionsdaten direkt aus der Blockchain zurück. Wenn eine Transaktion für die überwachten Adressen stattfindet, werden die unverarbeiteten Transaktionsdaten an deine Webhook-URL gesendet.Enhanced Webhooks stellen von Helius interpretierte Transaktionstypen bereit. Wir analysieren mehr als 100 Arten von Solana-Transaktionen (NFT-Listings, DeFi-Swaps, Übertragungen usw.) und abstrahieren sie in unser eigenes Schema.Verwende Raw Webhooks, wenn du alle Transaktionsdaten ohne Abstraktionen benötigst. Verwende Enhanced Webhooks, wenn du eine integrierte Erkennung und Analyse von Transaktionstypen benötigst.
When does the Webhook send a notification?
When does the Webhook send a notification?
Webhooks senden Benachrichtigungen unmittelbar, nachdem eine passende Transaktion auf der Blockchain bestätigt wurde.
Wiederholungsversuche
How should my endpoint acknowledge a webhook event?
How should my endpoint acknowledge a webhook event?
Dein endpoint muss innerhalb von 1 Sekunde den Statuscode
200 zurückgeben, um den erfolgreichen Empfang zu bestätigen. Als Best Practice solltest du sofort mit 200 antworten und die weitere Verarbeitung asynchron durchführen. So vermeidest du timeouts durch langsame Geschäftslogik.What is the retry policy for webhooks?
What is the retry policy for webhooks?
Helius versucht die Zustellung erneut, wenn dein endpoint einen
5xx-Fehler oder einen 4xx-Fehler (außer 403) zurückgibt, ein timeout auftritt oder die Zustellung aufgrund eines Verbindungs- oder DNS-Fehlers scheitert. Wir führen bis zu 3 Wiederholungsversuche mit einer Pause von 1 Sekunde zwischen den Versuchen durch.Wenn alle Wiederholungsversuche fehlschlagen, ist das Ereignis dauerhaft verloren. Es wird weder erneut in die Warteschlange gestellt noch gibt es einen zweiten Zustellungszyklus.Überwache deine Webhook-Protokolle im Helius Dashboard, um fehlgeschlagene Zustellungen zu erkennen und Probleme mit dem endpoint zu untersuchen.Für Enterprise-Tarife bieten wir außerdem anpassbare Richtlinien für Wiederholungsversuche an.Is a webhook event delivered exactly once?
Is a webhook event delivered exactly once?
Helius kann dasselbe Webhook-Ereignis mehrmals zustellen. Dies kann durch die Wiederholungslogik oder Netzwerkprobleme passieren.Dein Webhook-Handler muss Duplikate problemlos verarbeiten können. Wenn dasselbe Ereignis mehrmals verarbeitet wird, sollte dies zum gleichen Ergebnis führen wie eine einmalige Verarbeitung.Verwende die Transaktionssignatur oder eine eindeutige Ereignis-ID, um zu erfassen, welche Ereignisse du bereits verarbeitet hast.
Do webhooks post failed transactions?
Do webhooks post failed transactions?
Das hängt vom Webhook-Typ ab. Enhanced Webhooks senden keine fehlgeschlagenen Transaktionen. Raw Webhooks enthalten dagegen sowohl erfolgreiche als auch fehlgeschlagene Transaktionen.
Automatische Deaktivierung
Why was my webhook automatically disabled?
Why was my webhook automatically disabled?
Helius überwacht den Zustand von endpoints und deaktiviert Webhooks mit einer Zustellungsfehlerquote von ≥ 95 % automatisch. Kostenpflichtige Tarife (Dev und höher) werden über einen Zeitraum von 7 Tagen ausgewertet, Webhooks im Free-Tarif dagegen über einen Zeitraum von 24 Stunden. Dies verhindert unnötige Zustellungsversuche an nicht erreichbare endpoints.Häufige Ursachen sind eine nicht erreichbare endpoint-URL, durchgehend von deinem Server zurückgegebene Fehler-responses oder Netzwerk- beziehungsweise Firewall-Probleme, die Zustellungen von Helius blockieren.
How do I re-enable a disabled webhook?
How do I re-enable a disabled webhook?
- Behebe das zugrunde liegende Problem mit deinem endpoint.
- Melde dich beim Helius Dashboard an.
- Suche den deaktivierten Webhook und aktiviere ihn wieder.
{ "active": true }.Will my webhook get disabled again right after I re-enable it?
Will my webhook get disabled again right after I re-enable it?
Nein. Nach der erneuten Aktivierung beginnt für den Webhook eine 24-stündige Übergangsfrist, in der er nicht automatisch deaktiviert wird. So hast du Zeit, den Zustand deines endpoints vor der nächsten Auswertung zu überprüfen.
Will I be notified when a webhook is auto-disabled?
Will I be notified when a webhook is auto-disabled?
Ja. Nutzer mit dem Dev-Tarif oder höher erhalten eine E-Mail-Benachrichtigung, wenn ein Webhook automatisch deaktiviert wird. Nutzer des Free-Tarifs können den Webhook-Status im Helius Dashboard überwachen.
Can I disable a webhook without deleting it?
Can I disable a webhook without deleting it?
Ja. Du kannst Webhooks im Helius Dashboard oder über den API endpoint zum Umschalten von Webhooks ein- und ausschalten. So kannst du Zustellungen vorübergehend pausieren, ohne deine Webhook-Konfiguration zu verlieren.
Fehlerbehebung bei Webhooks
Why is my webhook dropping data?
Why is my webhook dropping data?
Datenverluste treten normalerweise auf, wenn an deinem endpoint ein Fehler auftritt. Dadurch werden Webhook-Zustellungen wiederholt, die schließlich fehlschlagen und zum Verlust von Daten führen. Prüfe deine Webhook-Protokolle im Dashboard, stelle eine ausreichende clientseitige Protokollierung sicher und kontaktiere den Support, wenn das Problem weiterhin besteht.
Why aren't my webhooks working?
Why aren't my webhooks working?
Stelle sicher, dass der ausgewählte Transaktionstyp zu den überwachten Transaktionen passt. Beginne mit dem Transaktionstyp “ANY”, um festzustellen, ob es sich um ein allgemeines Problem oder einen nicht übereinstimmenden Typ handelt. Teste mit webhook.site, ob das Problem an der Konfiguration deines endpoints liegt.
Why does my webhook not send me all transactions of a certain type (such as TOKEN_MINT)?
Why does my webhook not send me all transactions of a certain type (such as TOKEN_MINT)?
Der Webhook
TOKEN_MINT wird nur bei bestimmten Programmen wie Candy Machine V1 und Solana Program Library ausgelöst. Er deckt nicht alle Token-Minting-Ereignisse in der gesamten Blockchain ab. Für eine umfassendere Überwachung solltest du ein allgemeineres Konto- oder Programmabonnement über Webhooks mit dem Transaktionstypfilter “ANY” verwenden.Benötigst du weitere Hilfe?
Contact Support
Erhalte Hilfe von unserem Team über Discord, Chat oder E-Mail-Support.
Status Page
Prüfe die Verfügbarkeit und Leistungsinformationen des Dienstes in Echtzeit.