Skip to main content

​
这意味着什么

401 未授权 - 您的请求缺少有效的身份验证凭据。

​
常见原因

  • API 密钥无效或缺失
  • API 密钥放置在错误的位置
  • 访问控制规则阻止了您的请求
  • API 密钥已过期或被撤销

​
解决方案

  1. 验证您的 API 密钥格式
  2. 检查 API 密钥位置
    • 确保 API 密钥在查询参数中
    • 确认没有多余的空格或字符
  3. 查看访问控制规则
    • 检查您的 仪表板设置 中的 IP 限制
    • 如果使用浏览器请求，请确保您的域名在允许列表中
有关详细的身份验证设置，请参阅我们的 身份验证 指南。

​
这是什么意思

429 请求过多 - 您已超出计划的速率限制。

​
常见原因

  • 请求速度超过计划允许的限制
  • 瞬时流量超过极限
  • 多个应用程序共享同一个 API 密钥
  • 低效代码导致冗余请求

​
解决方案

  1. 监控您的使用情况
    • 检查您的仪表板中的 Rate Limited Requests 图表
    • 查看哪些端点达到限制
  2. 优化您的请求
    • 尽可能缓存响应
    • 将多个操作批量处理成单个调用
    • 删除不必要的轮询或重复请求
  3. 实施速率限制
    • 在应用程序中添加请求之间的延迟
    • 对重试使用指数退避
  4. 考虑升级
速率限制每分钟重置，因此临时限制通常会迅速解决。

​
这意味着什么

500 内部服务器错误 - 在处理您的请求时发生了服务器端错误。

​
常见原因

  • 请求负载格式错误
  • 服务器遇到临时问题
  • 无效参数导致服务器错误
  • 网络连接问题

​
解决方案

  1. 验证您的请求
    • 确保JSON负载格式正确
    • 验证是否包含所有必需参数
    • 检查参数类型是否与API规范匹配
  2. 检查服务状态
    • 访问 Helius 状态页面 查看正在进行的问题
    • 查找任何报告的中断或性能下降
  3. 实施重试逻辑
    • 等待几秒钟后再重试
    • 对多次尝试使用指数退避
  4. 获取支持
    • 如果错误持续，请联系支持并提供您的请求详细信息
    • 包括确切的请求负载和时间戳
服务器错误通常是暂时的，通常会自动解决。

​
这意味着什么

503 服务不可用 - 服务器暂时过载或正在维护。

​
常见原因

  • 高流量导致临时过载
  • 计划的维护窗口
  • 达到服务器容量限制
  • 网络基础设施问题

​
解决方案

  1. 等待并重试
    • 等待30-60秒后再试
    • 此错误通常会随着负载平衡而解决
  2. 实施智能重试
    • 使用指数退避（从1秒开始，然后是2秒，4秒等）
    • 设置最大重试限制（3-5次尝试）
    • 添加抖动以避免雷鸣般的羊群效应
  3. 检查维护情况
  4. 分配负载
    • 如果可能，分散请求时间
    • 避免可能触发过载保护的突发模式
503错误旨在是暂时的 - 随着服务器负载的减少，服务会自动恢复。

​
这意味着什么

504 Gateway Timeout - 服务器在超时时间内没有收到上游服务的响应。

​
常见原因

  • 网络连接问题
  • 复杂操作超过超时限制
  • 网络拥堵严重时区块链响应缓慢
  • 大量数据请求处理时间过长

​
解决方案

  1. 检查您的连接
    • 确保您的互联网连接稳定
    • 通过简单请求测试以排除本地问题
  2. 优化大请求
    • 将大型批量请求分成较小的部分
    • 对数据量大的查询使用分页
    • 考虑使用 WebSocket 连接以获取实时数据
  3. 实施超时
    • 在客户端代码中设置适当的超时值（30-60 秒）
    • 优雅地处理超时错误并重试
  4. 监控服务状态
网关超时通常表示网络拥堵或复杂操作。考虑将大请求分成较小的部分。

​
需要更多帮助？

联系支持

通过 Discord、聊天或电子邮件支持从我们的团队获取帮助。

状态页面

查看实时服务可用性和性能信息。