> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# エラーコードFAQ

> Helius RPCエンドポイントを使用する際のHTTPエラーコードのトラブルシューティング - 最も一般的な認証、レート制限、サーバーの問題を特定して解決

<AccordionGroup>
  <Accordion title="なぜ401エラーが発生するのですか？">
    ## 意味

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

    ## 一般的な原因

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

    ## 解決策

    1. **APIキーの形式を確認してください**

       ```
       https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
       ```

    2. **APIキーの配置を確認してください**
       * APIキーがクエリパラメータにあることを確認
       * 余分なスペースや文字がないことを確認

    3. **アクセス制御ルールを確認してください**
       * [ダッシュボード設定](https://dashboard.helius.dev/)でIP制限を確認
       * ブラウザリクエストを使用している場合は、ドメインが許可リストに登録されていることを確認

    <Info>詳細な認証設定については、[Authentication](/ja/api-reference/authentication)ガイドを参照してください。</Info>
  </Accordion>

  <Accordion title="なぜ429エラーが発生するのですか？">
    ## 意味

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

    ## 一般的な原因

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

    ## 解決策

    1. **使用状況を監視する**
       * [ダッシュボード](https://dashboard.helius.dev/usage)の`Rate Limited Requests`グラフを確認
       * 制限に達しているエンドポイントを確認

    2. **リクエストを最適化する**
       * 可能な限りレスポンスをキャッシュする
       * 複数の操作を一つのコールにまとめる
       * 不要なポーリングや重複リクエストを削除

    3. **レート制限を実装する**
       * アプリケーションでリクエスト間に遅延を追加
       * リトライの際に指数バックオフを使用

    4. **アップグレードを検討する**
       * 上位層の[プランとレート制限](/ja/billing/plans)を確認

    <Tip>レート制限は毎分リセットされるため、一時的なスロットリングは通常すぐに解決されます。</Tip>
  </Accordion>

  <Accordion title="なぜ500エラーが発生するのですか？">
    ## 意味

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

    ## 一般的な原因

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

    ## 解決策

    1. **リクエストを検証する**
       * JSONペイロードが適切にフォーマットされていることを確認
       * 必要なパラメータがすべて含まれていることを確認
       * パラメータの型がAPI仕様と一致していることを確認

    2. **サービスステータスを確認する**
       * [Helius Status Page](https://helius.statuspage.io/)で進行中の問題を確認
       * 報告されている障害やパフォーマンス低下を探す

    3. **リトライロジックを実装する**
       * リトライする前に数秒待つ
       * 複数回の試行に指数バックオフを使用

    4. **サポートを受ける**
       * エラーが続く場合は、リクエストの詳細とともにサポートに連絡
       * 正確なリクエストペイロードおよびタイムスタンプを含める

    <Note>サーバーエラーは通常一時的であり、自動的に解決されることが多いです。</Note>
  </Accordion>

  <Accordion title="なぜ503エラーが発生するのですか？">
    ## 意味

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

    ## 一般的な原因

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

    ## 解決策

    1. **待ってからリトライする**
       * 再試行する前に30-60秒待つ
       * このエラーは通常、負荷が調整されると解決します

    2. **スマートリトライを実装する**
       * 指数バックオフを使用（1秒、次に2秒、4秒など）
       * 最大リトライ回数を設定（3-5回）
       * 一斉アクセスを避けるためにジッターを追加

    3. **メンテナンスを確認する**
       * [Helius Status Page](https://helius.statuspage.io/)でメンテナンス情報を確認
       * 公表されたメンテナンスウィンドウに合わせて計画

    4. **負荷を分散する**
       * 可能であれば、リクエストを時間に分散
       * 過負荷保護を引き起こすピンポイントパターンを避ける

    <Tip>503エラーは一時的に設計されており、サーバーの負荷が減少するにつれて自動的に回復します。</Tip>
  </Accordion>

  <Accordion title="なぜ504エラーが発生するのですか？">
    ## 意味

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

    ## 一般的な原因

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

    ## 解決策

    1. **接続を確認する**
       * インターネット接続が安定していることを確認
       * 単純なリクエストでローカルの問題を排除

    2. **大きなリクエストを最適化する**
       * 大きなバッチリクエストを小さいチャンクに分ける
       * データが多いクエリにはページネーションを使用
       * リアルタイムデータにはWebSocket接続を検討

    3. **タイムアウトを実装する**
       * クライアントコードで適切なタイムアウト値を設定（30-60秒）
       * タイムアウトエラーを優雅にリトライで処理

    4. **サービスステータスを監視する**
       * [Helius Status Page](https://helius.statuspage.io/)でネットワーク問題を確認
       * 高チェーン混雑の報告を探す

    <Note>ゲートウェイタイムアウトは、ネットワークの混雑や複雑な操作を示すことが多いため、大きなリクエストを小さく分割することを検討してください。</Note>
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="サポートに連絡する" icon="headset" href="/ja/support/contact-support">
    Discord、チャット、またはメールサポートを介してチームからサポートを受けることができます。
  </Card>

  <Card title="ステータスページ" icon="wave-pulse" href="/ja/support/status-page">
    リアルタイムのサービスの可用性とパフォーマンス情報を確認します。
  </Card>
</CardGroup>