Skip to main content

​
Crédits et Limites de Taux

Jusqu’à 100 000 adresses en utilisant l’API.
Oui, modifier un webhook via l’API ou le tableau de bord coûte 100 crédits par requête. Cela s’applique à toute modification, y compris les changements d’URL, l’ajout/suppression d’adresses ou la mise à jour des types de transactions.
Chaque événement de webhook coûte 1 crédit lorsque Helius traite et envoie l’événement à votre point de terminaison. Vous êtes facturé que votre point de terminaison traite avec succès le webhook ou renvoie une erreur.
Toutes les opérations de gestion des webhooks (création, modification, suppression) coûtent 100 crédits par requête lorsqu’elles sont effectuées via l’API. Cela couvre le traitement requis pour mettre à jour vos configurations de webhook.

​
Réseaux Pris en Charge

Oui. Si vous créez un webhook via l’interface utilisateur, choisissez “devnet” comme “Réseau”. Si vous le créez via l’API Webhook, définissez le paramètre “webhookType” sur “rawDevnet”, “enhancedDevnet” ou “discordDevnet” selon le type de webhook souhaité.
Non — l’URL doit être accessible publiquement via HTTPS. Helius ne peut pas accéder aux serveurs de développement local via les URL localhost.

​
Utilisation des Webhooks

Définissez un en-tête d’autorisation lors de la création ou de la mise à jour du webhook. Helius répercute cette valeur dans l’en-tête Authorization lors de l’envoi de données à votre point de terminaison webhook, vous permettant de vérifier l’authenticité de la requête.
Les webhooks bruts renvoient des données de transaction Solana régulières directement de la blockchain. Lorsqu’une transaction se produit pour les adresses surveillées, les données de transaction brutes sont envoyées à votre URL de webhook.Les webhooks améliorés fournissent les types de transactions interprétés par Helius. Nous analysons plus de 100 types de transactions Solana (listes NFT, échanges DeFi, transferts, etc.) et les abstraisons dans notre propre schéma.Utilisez les webhooks bruts si vous souhaitez toutes les données de transaction sans abstraction, ou les webhooks améliorés si vous souhaitez une détection et une analyse des types de transactions intégrées.
Les webhooks envoient des notifications immédiatement après qu’une transaction correspondante est confirmée sur la blockchain.

​
Nouvelles Tentatives

Votre point de terminaison doit renvoyer un code de statut 200 dans un délai de 1 seconde pour reconnaître la réception réussie. Comme bonne pratique, répondez avec 200 immédiatement et traitez toute opération de manière asynchrone — cela évite les délais d’attente causés par une logique métier lente.
Helius retente la livraison lorsque votre point de terminaison renvoie une erreur 5xx, une erreur 4xx (sauf 403), expire, ou échoue en raison d’une erreur de connexion ou d’une défaillance DNS. Nous tentons jusqu’à 3 fois avec un intervalle de 1 seconde entre chaque tentative.Si toutes les tentatives de nouvelle tentative échouent, l’événement est perdu définitivement — il n’y a pas de nouvelle mise en file d’attente ou de second cycle de livraison.Surveillez vos journaux de webhook dans le Tableau de bord Helius pour identifier les échecs de livraison et enquêter sur les problèmes de point de terminaison.Nous proposons également des politiques de nouvelle tentative personnalisables pour les forfaits entreprises.
Helius peut livrer plusieurs fois le même événement de webhook. Cela peut se produire en raison de la logique de nouvelle tentative ou des problèmes réseau.Votre gestionnaire de webhook doit être prêt à gérer les doublons de manière élégante — traiter le même événement plusieurs fois doit produire le même résultat que le traiter une fois.Pour gérer les duplications, utilisez la signature de transaction ou un identifiant d’événement unique pour suivre les événements que vous avez déjà traités.
Cela dépend du type de webhook. Les webhooks améliorés n’envoient pas de transactions échouées, mais les webhooks bruts incluent les transactions réussies et échouées.

​
Désactivation Automatique

Helius surveille la santé du point de terminaison et désactive automatiquement les webhooks ayant un taux d’échec de livraison ≥ 95 %. Les forfaits payants (Dev et supérieur) sont évalués sur une période de 7 jours, tandis que les webhooks du forfait gratuit sont évalués sur une période de 24 heures. Cela permet d’éviter les tentatives de livraison inutiles vers des points de terminaison inaccessibles.Les causes courantes incluent une URL de point de terminaison injoignable, votre serveur renvoyant des réponses d’erreur cohérentes ou des problèmes de réseau/pare-feu bloquant les livraisons Helius.
  1. Corrigez le problème sous-jacent avec votre point de terminaison.
  2. Connectez-vous au Tableau de bord Helius.
  3. Trouvez le webhook désactivé et réactivez-le.
Vous pouvez également réactiver les webhooks par programmation via le Point de terminaison de l’API Toggle Webhook en envoyant une requête PATCH avec { "active": true }.
Non. Après réactivation, le webhook entre dans une période de grâce de 24 heures pendant laquelle il ne sera pas désactivé automatiquement. Cela vous permet de vérifier que votre point de terminaison est sain avant la prochaine évaluation.
Oui — les utilisateurs sur le forfait Dev et supérieur reçoivent une notification par e-mail lorsqu’un webhook est désactivé automatiquement. Les utilisateurs du forfait gratuit peuvent surveiller le statut des webhooks dans le Tableau de bord Helius.
Oui. Vous pouvez activer et désactiver les webhooks depuis le Tableau de bord Helius ou via le Point de terminaison de l’API Toggle Webhook. Cela vous permet de suspendre temporairement les livraisons sans perdre votre configuration de webhook.

​
Dépannage des Webhooks

La perte de données se produit généralement lorsque votre point de terminaison rencontre une erreur, provoquant des tentatives de webhook qui échouent finalement et entraînent une perte de données. Vérifiez vos journaux de webhook dans le tableau de bord, assurez-vous qu’une journalisation côté client suffisante est en place, et contactez le support si le problème persiste.
Assurez-vous que le type de transaction sélectionné correspond aux transactions que vous surveillez. Commencez par le type de transaction “ANY” pour identifier s’il s’agit d’un problème général ou d’une incompatibilité de type. Utilisez webhook.site pour tester si le problème provient de la configuration de votre point de terminaison.
Le webhook TOKEN_MINT ne se déclenche que pour certains programmes comme Candy Machine V1 et Solana Program Library. Il ne couvre pas tous les événements de minting de tokens à travers toute la blockchain. Pour une surveillance plus large, envisagez d’utiliser un abonnement de compte ou de programme plus général via des webhooks avec un filtrage de type de transaction “ANY”.

​
Besoin de Plus d’Aide ?

Contacter le Support

Obtenez de l’aide de notre équipe via Discord, chat ou support par e-mail.

Page de Statut

Vérifiez la disponibilité et les informations de performance des services en temps réel.