Why am I getting a 401 error?
Why am I getting a 401 error?
Что это означает
Распространённые причины
- Недействительный или отсутствующий ключ API
- Ключ API указан не в том месте
- Правила управления доступом блокируют запрос
- Срок действия ключа API истёк или ключ был отозван
Решения
-
Проверьте формат ключа API
-
Проверьте расположение ключа API
- Убедитесь, что ключ API указан в параметрах запроса
- Проверьте, нет ли лишних пробелов или символов
-
Проверьте правила управления доступом
- Проверьте ограничения по IP-адресам в настройках панели управления
- Если вы отправляете запросы из браузера, убедитесь, что ваш домен включён в список разрешённых
Подробные инструкции по настройке аутентификации приведены в руководстве Аутентификация.
Why am I getting a 429 error?
Why am I getting a 429 error?
Что это означает
Распространённые причины
- Запросы отправляются чаще, чем допускает ваш тарифный план
- Всплеск трафика превышает мгновенные ограничения
- Несколько приложений используют один ключ API
- Неэффективный код отправляет избыточные запросы
Решения
-
Отслеживайте использование
- Проверьте график
Rate Limited Requestsна панели управления - Проверьте, какие конечные точки достигают ограничений
- Проверьте график
-
Оптимизируйте запросы
- По возможности кэшируйте ответы
- Объединяйте несколько операций в один вызов
- Удалите ненужный опрос или повторяющиеся запросы
-
Реализуйте ограничение частоты запросов
- Добавьте в приложение задержки между запросами
- Используйте экспоненциальную задержку для повторных попыток
-
Рассмотрите переход на другой тарифный план
- Ознакомьтесь с разделом Тарифные планы и ограничения частоты запросов, чтобы узнать о тарифах более высокого уровня
Why am I getting a 500 error?
Why am I getting a 500 error?
Что это означает
Распространённые причины
- Некорректно сформированное содержимое запроса
- Временные проблемы на сервере
- Недопустимые параметры вызывают ошибки сервера
- Проблемы с сетевым подключением
Решения
-
Проверьте запрос
- Убедитесь, что содержимое JSON имеет правильный формат
- Проверьте наличие всех обязательных параметров
- Убедитесь, что типы параметров соответствуют спецификации API
-
Проверьте состояние сервиса
- Посетите страницу состояния Helius, чтобы узнать о текущих проблемах
- Проверьте сообщения о сбоях или снижении производительности
-
Реализуйте логику повторных попыток
- Подождите несколько секунд перед повторной попыткой
- Используйте экспоненциальную задержку при нескольких попытках
-
Обратитесь в службу поддержки
- Если ошибки сохраняются, обратитесь в службу поддержки и предоставьте сведения о запросе
- Укажите точное содержимое запроса и временную метку
Ошибки сервера обычно носят временный характер и, как правило, устраняются автоматически.
Why am I getting a 503 error?
Why am I getting a 503 error?
Что это означает
Распространённые причины
- Высокий трафик вызывает временную перегрузку
- Запланированные периоды технического обслуживания
- Достигнут предел мощности сервера
- Проблемы с сетевой инфраструктурой
Решения
-
Подождите и повторите попытку
- Подождите 30–60 секунд перед следующей попыткой
- Обычно эта ошибка исчезает после выравнивания нагрузки
-
Реализуйте интеллектуальные повторные попытки
- Используйте экспоненциальную задержку (начните с 1 с, затем 2 с, 4 с и т. д.)
- Задайте максимальное количество повторных попыток (3–5 попыток)
- Добавьте случайную задержку, чтобы избежать эффекта лавины запросов
-
Проверьте наличие технического обслуживания
- Проверьте запланированные работы на странице состояния Helius
- Учитывайте объявленные периоды технического обслуживания при планировании
-
Распределите нагрузку
- По возможности распределяйте запросы во времени
- Избегайте всплесков, которые могут активировать защиту от перегрузки
Why am I getting a 504 error?
Why am I getting a 504 error?
Что это означает
Распространённые причины
- Проблемы с сетевым подключением
- Сложные операции превышают ограничения времени ожидания
- Медленные ответы блокчейна при высокой нагрузке на сеть
- Обработка запросов большого объёма занимает слишком много времени
Решения
-
Проверьте подключение
- Убедитесь, что подключение к интернету стабильно
- Выполните простой запрос, чтобы исключить локальные проблемы
-
Оптимизируйте крупные запросы
- Разделите крупные пакетные запросы на меньшие части
- Используйте пагинацию для запросов с большим объёмом данных
- Для данных в реальном времени рассмотрите использование подключений WebSocket
-
Настройте время ожидания
- Задайте подходящие значения времени ожидания в клиентском коде (30–60 секунд)
- Корректно обрабатывайте ошибки времени ожидания с помощью повторных попыток
-
Отслеживайте состояние сервиса
- Проверьте сетевые проблемы на странице состояния Helius
- Найдите сообщения о высокой нагрузке на блокчейн
Истечение времени ожидания шлюза часто указывает на перегрузку сети или выполнение сложных операций. Рассмотрите возможность разделить крупные запросы на меньшие части.
Нужна дополнительная помощь?
Contact Support
Получите помощь нашей команды через Discord, чат или электронную почту.
Status Page
Проверьте доступность сервисов и сведения о производительности в реальном времени.