> ## 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.

# Часто задаваемые вопросы о кодах ошибок

> Устранение ошибок с кодами HTTP при использовании конечных точек Helius RPC: выявление и решение наиболее распространённых проблем с аутентификацией, ограничением частоты запросов и сервером

<AccordionGroup>
  <Accordion title="Why am I getting a 401 error?">
    ## Что это означает

    <Warning>**401 Unauthorized** — в запросе отсутствуют действительные учётные данные для аутентификации.</Warning>

    ## Распространённые причины

    * Недействительный или отсутствующий ключ API
    * Ключ API указан не в том месте
    * Правила управления доступом блокируют запрос
    * Срок действия ключа API истёк или ключ был отозван

    ## Решения

    1. **Проверьте формат ключа API**

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

    2. **Проверьте расположение ключа API**
       * Убедитесь, что ключ API указан в параметрах запроса
       * Проверьте, нет ли лишних пробелов или символов

    3. **Проверьте правила управления доступом**
       * Проверьте ограничения по IP-адресам в [настройках панели управления](https://dashboard.helius.dev/)
       * Если вы отправляете запросы из браузера, убедитесь, что ваш домен включён в список разрешённых

    <Info>Подробные инструкции по настройке аутентификации приведены в руководстве [Аутентификация](/docs/ru/api-reference/authentication).</Info>
  </Accordion>

  <Accordion title="Why am I getting a 429 error?">
    ## Что это означает

    <Warning>**429 Too Many Requests** — вы превысили ограничения частоты запросов для своего тарифного плана.</Warning>

    ## Распространённые причины

    * Запросы отправляются чаще, чем допускает ваш тарифный план
    * Всплеск трафика превышает мгновенные ограничения
    * Несколько приложений используют один ключ API
    * Неэффективный код отправляет избыточные запросы

    ## Решения

    1. **Отслеживайте использование**
       * Проверьте график `Rate Limited Requests` на [панели управления](https://dashboard.helius.dev/usage)
       * Проверьте, какие конечные точки достигают ограничений

    2. **Оптимизируйте запросы**
       * По возможности кэшируйте ответы
       * Объединяйте несколько операций в один вызов
       * Удалите ненужный опрос или повторяющиеся запросы

    3. **Реализуйте ограничение частоты запросов**
       * Добавьте в приложение задержки между запросами
       * Используйте экспоненциальную задержку для повторных попыток

    4. **Рассмотрите переход на другой тарифный план**
       * Ознакомьтесь с разделом [Тарифные планы и ограничения частоты запросов](/docs/ru/billing/plans), чтобы узнать о тарифах более высокого уровня

    <Tip>Ограничения частоты запросов сбрасываются каждую минуту, поэтому временное ограничение обычно быстро снимается.</Tip>
  </Accordion>

  <Accordion title="Why am I getting a 500 error?">
    ## Что это означает

    <Warning>**500 Internal Server Error** — при обработке запроса произошла ошибка на стороне сервера.</Warning>

    ## Распространённые причины

    * Некорректно сформированное содержимое запроса
    * Временные проблемы на сервере
    * Недопустимые параметры вызывают ошибки сервера
    * Проблемы с сетевым подключением

    ## Решения

    1. **Проверьте запрос**
       * Убедитесь, что содержимое JSON имеет правильный формат
       * Проверьте наличие всех обязательных параметров
       * Убедитесь, что типы параметров соответствуют спецификации API

    2. **Проверьте состояние сервиса**
       * Посетите [страницу состояния Helius](https://helius.statuspage.io/), чтобы узнать о текущих проблемах
       * Проверьте сообщения о сбоях или снижении производительности

    3. **Реализуйте логику повторных попыток**
       * Подождите несколько секунд перед повторной попыткой
       * Используйте экспоненциальную задержку при нескольких попытках

    4. **Обратитесь в службу поддержки**
       * Если ошибки сохраняются, обратитесь в службу поддержки и предоставьте сведения о запросе
       * Укажите точное содержимое запроса и временную метку

    <Note>Ошибки сервера обычно носят временный характер и, как правило, устраняются автоматически.</Note>
  </Accordion>

  <Accordion title="Why am I getting a 503 error?">
    ## Что это означает

    <Warning>**503 Service Unavailable** — сервер временно перегружен или находится на техническом обслуживании.</Warning>

    ## Распространённые причины

    * Высокий трафик вызывает временную перегрузку
    * Запланированные периоды технического обслуживания
    * Достигнут предел мощности сервера
    * Проблемы с сетевой инфраструктурой

    ## Решения

    1. **Подождите и повторите попытку**
       * Подождите 30–60 секунд перед следующей попыткой
       * Обычно эта ошибка исчезает после выравнивания нагрузки

    2. **Реализуйте интеллектуальные повторные попытки**
       * Используйте экспоненциальную задержку (начните с 1 с, затем 2 с, 4 с и т. д.)
       * Задайте максимальное количество повторных попыток (3–5 попыток)
       * Добавьте случайную задержку, чтобы избежать эффекта лавины запросов

    3. **Проверьте наличие технического обслуживания**
       * Проверьте запланированные работы на [странице состояния Helius](https://helius.statuspage.io/)
       * Учитывайте объявленные периоды технического обслуживания при планировании

    4. **Распределите нагрузку**
       * По возможности распределяйте запросы во времени
       * Избегайте всплесков, которые могут активировать защиту от перегрузки

    <Tip>Ошибки 503 являются временными: сервис автоматически восстанавливается по мере снижения нагрузки на сервер.</Tip>
  </Accordion>

  <Accordion title="Why am I getting a 504 error?">
    ## Что это означает

    <Warning>**504 Gateway Timeout** — сервер не получил ответ от вышестоящих сервисов за отведённое время ожидания.</Warning>

    ## Распространённые причины

    * Проблемы с сетевым подключением
    * Сложные операции превышают ограничения времени ожидания
    * Медленные ответы блокчейна при высокой нагрузке на сеть
    * Обработка запросов большого объёма занимает слишком много времени

    ## Решения

    1. **Проверьте подключение**
       * Убедитесь, что подключение к интернету стабильно
       * Выполните простой запрос, чтобы исключить локальные проблемы

    2. **Оптимизируйте крупные запросы**
       * Разделите крупные пакетные запросы на меньшие части
       * Используйте пагинацию для запросов с большим объёмом данных
       * Для данных в реальном времени рассмотрите использование подключений WebSocket

    3. **Настройте время ожидания**
       * Задайте подходящие значения времени ожидания в клиентском коде (30–60 секунд)
       * Корректно обрабатывайте ошибки времени ожидания с помощью повторных попыток

    4. **Отслеживайте состояние сервиса**
       * Проверьте сетевые проблемы на [странице состояния Helius](https://helius.statuspage.io/)
       * Найдите сообщения о высокой нагрузке на блокчейн

    <Note>Истечение времени ожидания шлюза часто указывает на перегрузку сети или выполнение сложных операций. Рассмотрите возможность разделить крупные запросы на меньшие части.</Note>
  </Accordion>
</AccordionGroup>

## Нужна дополнительная помощь?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset" href="/docs/ru/support/contact-support">
    Получите помощь нашей команды через Discord, чат или электронную почту.
  </Card>

  <Card title="Status Page" icon="wave-pulse" href="/docs/ru/support/status-page">
    Проверьте доступность сервисов и сведения о производительности в реальном времени.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.