メインコンテンツへスキップ

​
クレジットとレート制限

APIを使用して最大100,000のアドレスを入力できます。
はい、APIまたはダッシュボードを介してWebhookを編集することは、リクエストごとに100クレジットのコストがかかります。これは、URLの変更、アドレスの追加/削除、またはトランザクションタイプの更新など、すべての修正に適用されます。
Heliusがイベントを処理してエンドポイントに送信するたびに、各Webhookイベントは1クレジットかかります。エンドポイントがWebhookを正常に処理したかエラーを返したかに関係なく、料金がかかります。
APIを介して行われるWebhook管理操作（作成、編集、削除）は、リクエストごとに100クレジットのコストがかかります。これはWebhook設定を更新するために必要な処理をカバーします。

​
サポートされているネットワーク

はい。UIを通じてWebhookを作成する場合、「devnet」を「Network」として選択します。Webhook APIを介して作成する場合、「webhookType」パラメータを「rawDevnet」「enhancedDevnet」または「discordDevnet」に設定します。
いいえ—URLはHTTPSを介して公開アクセス可能でなければなりません。Heliusはlocalhost URLを介してローカル開発サーバーにアクセスできません。

​
Webhooksの使用

Webhookを作成または更新する際に、認証ヘッダーを設定します。Heliusはこの値をデータをWebhookエンドポイントに送信する際にAuthorizationヘッダーでエコーし、リクエストの真正性を確認できます。
Raw Webhooksはブロックチェーンから直接Solanaトランザクションデータを返します。モニタリング対象のアドレスでトランザクションが発生すると、生のトランザクションデータがWebhook URLに送信されます。Enhanced WebhooksはHeliusの解釈したトランザクションタイプを提供します。100種類以上のSolanaトランザクション（NFTリスティング、DeFiスワップ、転送など）を解析し、独自のスキーマに抽象化します。生のWebhooksを使用すると、抽象化なしで全てのトランザクションデータが取得され、内蔵のトランザクションタイプ検出と解析が欲しい場合はEnhanced Webhooksを使用します。
Webhookは、ブロックチェーン上で一致するトランザクションが確認された直後に通知を送信します。

​
リトライ

エンドポイントは、1秒以内に200ステータスコードを返して正常な受信を確認する必要があります。ベストプラクティスとして、即座に200で応答し、処理は非同期で行います — これは遅いビジネスロジックによるタイムアウトを防ぎます。
Heliusは、エンドポイントが5xxエラー、4xxエラー（403を除く）、タイムアウト、または接続エラーやDNS障害により失敗した場合に配信をリトライします。最大3回まで1秒間隔でリトライします。すべてのリトライが失敗した場合、イベントは永久に失われます — 再キューや二次配信サイクルはありません。Helius DashboardでWebhookログを監視し、配信失敗を特定し、エンドポイントの問題を調査します。エンタープライズプランでは、カスタマイズ可能なリトライポリシーも提供しています。
Heliusは同じWebhookイベントを複数回配信することがあります。これはリトライロジックやネットワークの問題によるものです。Webhookハンドラは重複を管理する必要があります — 同じイベントを複数回処理しても、1回だけ処理する場合と同じ結果を生成するべきです。重複を管理するために、トランザクション署名またはユニークなイベント識別子を使用して、すでに処理したイベントを追跡します。
Webhookのタイプによります。Enhanced Webhooksは失敗したトランザクションを送信しませんが、Raw Webhooksは成功したトランザクションと失敗したトランザクションの両方を含みます。

​
自動無効化

Heliusはエンドポイントの健全性を監視し、配信失敗率**≥ 95%**のWebhookを自動的に無効にします。有料プラン（Dev以上）は7日間のウィンドウで評価され、フリープランのWebhookは24時間のウィンドウで評価されます。これは到達不能なエンドポイントへの無駄な配信試行を防ぎます。一般的な原因には、到達不能なエンドポイントURL、サーバーが一貫してエラー応答を返すこと、またはネットワーク/ファイアウォールの問題でHeliusの配信がブロックされることが含まれます。
  1. エンドポイントの根本的な問題を修正します。
  2. Helius Dashboardにログインします。
  3. 無効になったWebhookを見つけて再度オンに切り替えます。
Toggle Webhook APIエンドポイントを介してPATCHリクエストを送信し、プログラムでWebhookを再有効化することもできます。
いいえ。再度有効にした後、Webhookは24時間の猶予期間に入り、その間は自動的に無効になりません。これは次回の評価前にエンドポイントが正常であることを確認する時間を提供します。
はい — Devプラン以上のユーザーには、Webhookが自動的に無効になった際にメール通知が送られます。フリープランのユーザーはHelius DashboardでWebhookのステータスを監視できます。
はい。Helius DashboardまたはToggle Webhook APIエンドポイント経由でWebhooksをオン・オフ切り替えることができます。これはWebhook設定を保持したまま配信を一時停止することを可能にします。

​
Webhooksのトラブルシューティング

データのドロップは通常、エンドポイントがエラーに遭遇し、Webhook再試行が最終的に失敗し、データ損失につながる時に発生します。ダッシュボードでWebhookログを確認し、十分なクライアントサイドログを実装し、問題が解決しない場合はサポートに連絡してください。
選択したトランザクションタイプが監視しているトランザクションと一致しているか確認してください。「ANY」トランザクションタイプから始めて、一般的な問題かタイプの不一致かを特定します。webhook.siteを使用して、問題がエンドポイント設定にあるかどうかをテストしてください。
TOKEN_MINT WebhookはCandy Machine V1やSolana Program Libraryのような特定のプログラムでのみトリガーされます。ブロックチェーン全体の全てのトークンミントイベントをカバーしているわけではありません。より広範囲な監視を行うには、「ANY」トランザクションタイプフィルタリングを使用したWebhookによるより一般的なアカウントまたはプログラムサブスクリプションを検討してください。

​
さらに助けが必要ですか？

サポートに連絡

Discord、チャット、またはメールサポートを通じて当社のチームから助けを得ることができます。

ステータスページ

リアルタイムのサービス可用性とパフォーマンス情報を確認できます。