配额和速率限制
一个 webhook 可以输入多少个地址？
一个 webhook 可以输入多少个地址？
使用 API 最多可以输入 100,000 个地址。
在创建 webhook 后，如果我在 Helius 仪表板中更改 webhook URL，会被扣除积分吗？
在创建 webhook 后，如果我在 Helius 仪表板中更改 webhook URL，会被扣除积分吗？
是的，通过 API 或仪表板编辑 webhook 每次请求需要 100 积分。这适用于任何修改，包括 URL 更改、添加/删除地址或更新交易类型。
接收 webhook 通知需要多少积分？
接收 webhook 通知需要多少积分？
每个 webhook 事件在 Helius 处理并发送到您的端点时需要 1 积分。无论您的端点是否成功处理 webhook 或返回错误，您都将被扣除积分。
创建、编辑和删除 webhooks 需要多少积分？
创建、编辑和删除 webhooks 需要多少积分？
通过 API 执行的所有 webhook 管理操作（创建、编辑、删除）每次请求需要 100 积分。这涵盖了更新您的 webhook 配置所需的处理。
支持的网络
Solana Devnet 上是否提供 webhooks？
Solana Devnet 上是否提供 webhooks？
是的。如果您通过 UI 创建 webhook，请选择“devnet”作为“Network”。如果您通过 Webhook API 创建它，请根据所需的 webhook 类型将“webhookType”参数设置为 “rawDevnet”、“enhancedDevnet” 或 “discordDevnet”。
我可以为我的 webhook URL 输入 'localhost' 吗？
我可以为我的 webhook URL 输入 'localhost' 吗？
不可以——URL 必须通过 HTTPS 公开可访问。Helius 无法通过 localhost URL 访问本地开发服务器。
使用 Webhooks
我如何验证 webhook 来自 Helius？
我如何验证 webhook 来自 Helius？
在创建或更新 webhook 时设置授权 header。在将数据发送到您的 webhook 端点时，Helius 会在
Authorization header 中回显此值，从而允许您验证请求的真实性。'原始'和'增强'webhooks有什么区别？
'原始'和'增强'webhooks有什么区别？
原始webhooks直接从区块链返回常规的Solana交易数据。当监控的地址发生交易时，原始交易数据会被发送到您的webhook URL。增强webhooks提供Helius解释的交易类型。我们解析超过100种Solana交易类型（NFT列表、DeFi交换、转账等），并将其抽象为我们自己的模式。如果您想要所有的交易数据而不进行抽象，请使用原始webhooks；如果您想要内置的交易类型检测和解析，请使用增强webhooks。
Webhook何时发送通知？
Webhook何时发送通知？
Webhooks在匹配的交易在区块链上确认后立即发送通知。
重试
什么是webhook的重试策略？
什么是webhook的重试策略？
如果您的服务器出错或超时，Helius将重新尝试传递。您的端点应返回200状态码以确认成功接收。如果您的端点返回错误状态码或根本没有响应，我们将以1分钟的间隔重试传递最多3次。如果所有重试尝试都失败，webhook事件将被丢弃。在Helius仪表板中监控您的webhook日志，以识别传递失败并调查端点问题。我们还为企业计划提供可定制的重试策略。
webhook事件是否只传递一次？
webhook事件是否只传递一次？
Helius可能会多次传递相同的webhook事件。这可能是由于重试逻辑或网络问题导致的。您的webhook处理程序必须准备好优雅地处理重复事件——多次处理相同事件应产生与处理一次相同的结果。要处理重复事件，请使用交易签名或唯一事件标识符来跟踪您已处理的事件。
webhook是否发送失败的交易？
webhook是否发送失败的交易？
这取决于webhook的类型。增强型webhook不发送失败的交易，但原始webhook会包括成功和失败的交易。
自动禁用
为什么我的 webhook 会自动禁用？
为什么我的 webhook 会自动禁用？
Helius 监控端点健康状况，并自动禁用交付失败率达到 ≥ 95% 的 webhook。付费计划（Dev 及以上）在 7 天窗口期内评估，而免费计划的 webhook 在 24 小时内评估。这可以防止对无法访问的端点进行无效投递尝试。常见原因包括端点 URL 不可访问、您的服务器返回一致的错误响应或网络/防火墙问题阻止 Helius 的交付。
如何重新启用已禁用的 webhook？
如何重新启用已禁用的 webhook？
- 修复端点的根本问题。
- 登录 Helius Dashboard。
- 找到被禁用的 webhook 并将其重新启用。
{ "active": true } 的 PATCH 请求，通过 Toggle Webhook API 端点 以编程方式重新启用 webhooks。重新启用后我的 webhook 会再次被禁用吗？
重新启用后我的 webhook 会再次被禁用吗？
不会。在重新启用后，webhook 进入 24 小时宽限期，在此期间不会被自动禁用。这给您时间以验证您的端点是否健康，然后再进行下一次评估。
当 webhook 自动禁用时我会收到通知吗？
当 webhook 自动禁用时我会收到通知吗？
会——Dev 计划及以上的用户会在 webhook 自动禁用时收到电子邮件通知。免费计划用户可以在 Helius Dashboard 中监控 webhook 状态。
我可以在不删除的情况下禁用 webhook 吗？
我可以在不删除的情况下禁用 webhook 吗？
可以。您可以从 Helius Dashboard 或通过 Toggle Webhook API endpoint 切换 webhooks 的开关。这使您可以在不丢失 webhook 配置的情况下临时暂停传递。
排查 Webhooks 问题
为什么我的 webhook 会丢弃数据？
为什么我的 webhook 会丢弃数据？
为什么我的 webhooks 不工作？
为什么我的 webhooks 不工作？
确保选择的事务类型与您正在监控的事务匹配。首先使用 “ANY” 事务类型以确定是否是常规问题或类型不匹配。使用 webhook.site 测试问题是否出在端点配置上。
为什么我的 webhook 没有发送给我某一类型的所有事务（例如 TOKEN_MINT）？
为什么我的 webhook 没有发送给我某一类型的所有事务（例如 TOKEN_MINT）？
TOKEN_MINT webhook 仅触发特定程序，如 Candy Machine V1 和 Solana Program Library。它不涵盖整个区块链的所有代币铸造事件。要进行更广泛的监控，可以考虑通过具有 “ANY” 事务类型过滤的 webhooks 使用更通用的账户或程序订阅。需要更多帮助？
联系支持
通过 Discord、聊天或电子邮件支持获取我们团队的帮助。
状态页面
查看实时服务可用性和性能信息。