Skip to main content
Helius API использует ключи API для аутентификации запросов. Каждый запрос к API должен содержать ваш ключ API для проверки вашей личности и разрешений.
Ваш ключ API — это конфиденциальная информация, которая предоставляет доступ к вашей учетной записи Helius. Никогда не размещайте его в клиентском коде, общедоступных репозиториях или доступных из браузера областях.

Начало работы

1. Создайте ключ API

1

Sign up or log in

Создайте учетную запись в панели управления Helius или войдите в существующую учетную запись.
2

Navigate to API Keys

Перейдите в раздел Ключи API на боковой панели.
3

Generate a new key

Нажмите Создать новый ключ API и укажите понятное название проекта (например, «Рабочее приложение» или «Среда разработки»).
4

Copy and secure your key

Сразу скопируйте ключ API и сохраните его в безопасном месте. После перехода на другую страницу вы больше не сможете его увидеть.

2. Используйте ключ API

Добавляйте ключ API как параметр запроса во все запросы:

Начало работы (для агентов)

Агенты могут программно регистрировать учетные записи Helius, создавать проекты и генерировать ключи API с помощью Helius CLI. Полные инструкции доступны по адресу: https://dashboard.helius.dev/agents.md

Установите Helius CLI

Создайте пару ключей

Пополните созданный кошелек (только для автоплатежа)

Пропустите этот шаг, если платите по размещенной платежной ссылке (это режим регистрации по умолчанию, который завершается с помощью helius signup --resume). При автоплатеже (--pay) средства списываются с локальной пары ключей: отправьте на адрес кошелька из предыдущего шага стоимость плана в USDC (10 долларов США для плана Agent) и около 0,001 SOL.

Зарегистрируйтесь и получите ключ API

Для каждой новой регистрации, включая план Agent, требуются --email, --first-name и --last-name. Кошелек используется только для оплаты.

Рекомендации по безопасности

Environment Variables

Храните ключ API в переменных окружения, а не в исходном коде.

IP Restrictions

Настройте ограничения по IP-адресам для ключей API в панели управления, чтобы разрешить доступ только с определенных IP-адресов или из заданных диапазонов.

Separate Keys

Используйте разные ключи API для сред разработки, тестирования и эксплуатации, чтобы изолировать их использование и повысить безопасность.

Monitor Usage

Регулярно проверяйте использование API в панели управления, чтобы выявлять необычные закономерности или потенциальные проблемы безопасности.

Управление секретами

Ограничения частоты запросов и использование

Ограничения частоты запросов зависят от плана подписки. Отслеживайте использование в панели управления Helius, чтобы не превышать выделенные лимиты.

Об ограничениях частоты запросов

  • Запросов в секунду: зависит от уровня подписки
  • Месячная квота запросов: общее количество запросов, разрешенное за расчетный период
  • Допустимые всплески: кратковременное превышение базового ограничения частоты запросов

Обработка ограничений частоты запросов

Устранение неполадок

Признаки: ошибки 401 Unauthorized или «Invalid API Key»Решения:
  • Убедитесь, что ключ API указан правильно и не был создан заново
  • Убедитесь, что ключ API передается как параметр запроса: ?api-key=YOUR_KEY
  • Убедитесь, что в ключе API нет лишних пробелов или символов
  • Убедитесь, что срок действия ключа API не истек и ключ не был отозван
Признаки: ошибки 429 Too Many RequestsРешения:
  • Проверьте текущее использование в панели управления
  • Реализуйте экспоненциальную задержку в логике повторных попыток
  • Рассмотрите переход на план с более высокими лимитами
  • Оптимизируйте запросы, чтобы сократить количество ненужных вызовов
Признаки: ошибки 403 ForbiddenРешения:
  • Убедитесь, что ограничения по IP-адресам не блокируют ваши запросы
  • Проверьте, предоставляет ли ваша подписка доступ к этой конечной точке
  • Убедитесь, что ключ API имеет необходимые разрешения

Дальнейшие действия

Quickstart Guide

Начните выполнять первые вызовы API с помощью Helius

API Reference

Изучите все доступные конечные точки и методы

Rate Limits

Узнайте об ограничениях частоты запросов и вариантах перехода на другой план

Dashboard

Отслеживайте использование API и управляйте ключами

Поддержка

Нужна помощь с аутентификацией или появились вопросы о ключах API?

Discord Community

Присоединяйтесь к нашему сообществу в Discord, чтобы получать помощь в реальном времени и поддержку сообщества

Email Support

Свяжитесь с нашей службой поддержки напрямую