Skip to main content

意味

401 Unauthorized - リクエストには有効な認証資格情報が不足しています。

一般的な原因

  • APIキーが無効または不足している
  • APIキーが間違った場所に含まれている
  • アクセス制御ルールがリクエストをブロックしている
  • APIキーが期限切れや取り消されている

解決策

  1. APIキーの形式を確認してください
  2. APIキーの配置を確認してください
    • APIキーがクエリパラメータにあることを確認
    • 余分なスペースや文字がないことを確認
  3. アクセス制御ルールを確認してください
    • ダッシュボード設定でIP制限を確認
    • ブラウザリクエストを使用している場合は、ドメインが許可リストに登録されていることを確認
詳細な認証設定については、Authenticationガイドを参照してください。

意味

429 Too Many Requests - プランのレート制限を超えました。

一般的な原因

  • プランが許可する速度を超えてリクエストを行っている
  • 瞬間的な制限を超えるバーストトラフィック
  • 複数のアプリケーションが同じAPIキーを共有している
  • 非効率なコードが冗長なリクエストを行っている

解決策

  1. 使用状況を監視する
    • ダッシュボードRate Limited Requestsグラフを確認
    • 制限に達しているエンドポイントを確認
  2. リクエストを最適化する
    • 可能な限りレスポンスをキャッシュする
    • 複数の操作を一つのコールにまとめる
    • 不要なポーリングや重複リクエストを削除
  3. レート制限を実装する
    • アプリケーションでリクエスト間に遅延を追加
    • リトライの際に指数バックオフを使用
  4. アップグレードを検討する
レート制限は毎分リセットされるため、一時的なスロットリングは通常すぐに解決されます。

意味

500 Internal Server Error - サーバー側でリクエストの処理中にエラーが発生しました。

一般的な原因

  • 不正なフォーマットのリクエストペイロード
  • サーバーが一時的な問題を経験している
  • 無効なパラメータがサーバーエラーを引き起こしている
  • ネットワーク接続の問題

解決策

  1. リクエストを検証する
    • JSONペイロードが適切にフォーマットされていることを確認
    • 必要なパラメータがすべて含まれていることを確認
    • パラメータの型がAPI仕様と一致していることを確認
  2. サービスステータスを確認する
    • Helius Status Pageで進行中の問題を確認
    • 報告されている障害やパフォーマンス低下を探す
  3. リトライロジックを実装する
    • リトライする前に数秒待つ
    • 複数回の試行に指数バックオフを使用
  4. サポートを受ける
    • エラーが続く場合は、リクエストの詳細とともにサポートに連絡
    • 正確なリクエストペイロードおよびタイムスタンプを含める
サーバーエラーは通常一時的であり、自動的に解決されることが多いです。

意味

503 Service Unavailable - サーバーが一時的に過負荷またはメンテナンス中です。

一般的な原因

  • 高トラフィックによる一時的な過負荷
  • スケジュールされたメンテナンスウィンドウ
  • サーバーの容量制限に達している
  • ネットワークインフラの問題

解決策

  1. 待ってからリトライする
    • 再試行する前に30-60秒待つ
    • このエラーは通常、負荷が調整されると解決します
  2. スマートリトライを実装する
    • 指数バックオフを使用(1秒、次に2秒、4秒など)
    • 最大リトライ回数を設定(3-5回)
    • 一斉アクセスを避けるためにジッターを追加
  3. メンテナンスを確認する
    • Helius Status Pageでメンテナンス情報を確認
    • 公表されたメンテナンスウィンドウに合わせて計画
  4. 負荷を分散する
    • 可能であれば、リクエストを時間に分散
    • 過負荷保護を引き起こすピンポイントパターンを避ける
503エラーは一時的に設計されており、サーバーの負荷が減少するにつれて自動的に回復します。

意味

504 Gateway Timeout - サーバーがタイムアウト期間内に上流サービスからの応答を受け取れませんでした。

一般的な原因

  • ネットワーク接続の問題
  • 複雑な操作がタイムアウト制限を超えている
  • 高ネットワーク混雑時の遅いブロックチェーン応答
  • 大きなデータリクエストが処理に時間がかかりすぎている

解決策

  1. 接続を確認する
    • インターネット接続が安定していることを確認
    • 単純なリクエストでローカルの問題を排除
  2. 大きなリクエストを最適化する
    • 大きなバッチリクエストを小さいチャンクに分ける
    • データが多いクエリにはページネーションを使用
    • リアルタイムデータにはWebSocket接続を検討
  3. タイムアウトを実装する
    • クライアントコードで適切なタイムアウト値を設定(30-60秒)
    • タイムアウトエラーを優雅にリトライで処理
  4. サービスステータスを監視する
    • Helius Status Pageでネットワーク問題を確認
    • 高チェーン混雑の報告を探す
ゲートウェイタイムアウトは、ネットワークの混雑や複雑な操作を示すことが多いため、大きなリクエストを小さく分割することを検討してください。

さらにヘルプが必要ですか?

サポートに連絡する

Discord、チャット、またはメールサポートを介してチームからサポートを受けることができます。

ステータスページ

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