入门指南
1. 创建您的 API 密钥
1
注册或登录
在 Helius 控制台上创建一个账户或登录到已有账户。
2
导航到 API 密钥
转到控制台侧边栏中的 API 密钥 部分。
3
生成新密钥
点击 创建新 API 密钥 并为您的项目提供一个描述性名称(例如,“生产应用程序”,“开发环境”)。
4
复制并安全存储您的密钥
立即复制您的 API 密钥并安全存储。一旦导航离开,您将无法再次查看它。
2. 使用您的 API 密钥
在所有请求中包含您的 API 密钥作为查询参数:入门指南(针对代理)
代理可以通过编程方式注册Helius账户、创建项目,并使用Helius CLI生成API密钥。 完整说明请参阅:https://dashboard.helius.dev/agents.md安装 Helius CLI
生成密钥对
为生成的钱包提供资金(仅限自动支付)
如果通过托管支付链接付款,请跳过此步骤(这是默认注册模式,使用helius signup --resume 完成注册)。自动付款(--pay)将从本地密钥对付款:向上一步中的钱包地址发送相应套餐金额的 USDC(Agent 套餐为 $10)和约 0.001 SOL。
注册并获取API密钥
每次新注册(包括 Agent 套餐)都需要--email、--first-name 和 --last-name。该钱包仅用于付款。
安全最佳实践
Environment Variables
将 API 密钥存储在环境变量中,而不是源代码中。
IP Restrictions
在控制面板中为 API 密钥设置 IP 限制,将访问权限限定到特定 IP 地址或地址范围。
Separate Keys
为开发、预发布和生产环境使用不同的 API 密钥,以隔离使用情况并提高安全性。
Monitor Usage
定期在控制面板中检查 API 使用情况,以检测异常模式或潜在安全问题。
密钥管理
- Node.js
- Python
- Docker
速率限制与用量
速率限制因订阅套餐而异。请在 Helius 控制面板中监控用量,确保不超出分配的限额。
了解速率限制
- 每秒请求数:取决于你的订阅等级
- 每月请求配额:每个计费周期允许的请求总数
- 突发额度:允许短期超过基础速率限制的请求峰值
处理速率限制
故障排除
Invalid API Key Error
Invalid API Key Error
症状:出现 401 Unauthorized 或“API 密钥无效”错误解决方案:
- 验证 API 密钥是否正确且未重新生成
- 检查是否已将 API 密钥作为查询参数包含在内:
?api-key=YOUR_KEY - 确保 API 密钥中没有多余的空格或字符
- 确认 API 密钥未过期或被撤销
Rate Limit Exceeded
Rate Limit Exceeded
症状:出现 429 Too Many Requests 错误解决方案:
- 在控制面板中检查当前用量
- 在重试逻辑中实现指数退避
- 考虑升级套餐以获得更高限额
- 优化请求以减少不必要的调用
Forbidden Access
Forbidden Access
症状:出现 403 Forbidden 错误解决方案:
- 验证 IP 限制是否阻止了你的请求
- 检查你的订阅是否包含该端点的访问权限
- 确保 API 密钥具有必要权限
后续步骤
Quickstart Guide
开始使用 Helius 发起你的第一个 API 调用
API Reference
探索所有可用的端点和方法
Rate Limits
了解速率限制和升级选项
Dashboard
监控 API 用量并管理密钥
支持
需要身份验证方面的帮助,或对 API 密钥有疑问?Discord Community
加入我们的 Discord,获取实时帮助和社区支持
Email Support
直接联系我们的支持团队