Hubvix

Для разработчиков

Управляйте проектами через API

Подключите свою интеграцию к аккаунту Hubvix: создайте проект, загрузите код, запустите сервисы и следите за результатом.

Открыть кабинет и создать ключОткрыть OpenAPI

Ключи с нужными правами

Создайте постоянный ключ для интеграции или временный для отдельной задачи. Выберите права и срок действия.

Один аккаунт и те же правила

API работает с проектами владельца ключа, его балансом, тарифами и доступными ресурсами.

Наблюдение за запуском

Получайте ID операций и проверяйте состояние проекта, сервисов, сборки и логов.

Быстрый старт

Проверьте доступ к аккаунту

API base URL: https://api.hubvix.ru. Передавайте ключ только в HTTP-заголовке.

curl --fail-with-body --silent --show-error \
  'https://api.hubvix.ru/api/v1/me' \
  -H "Authorization: Bearer $HUBVIX_AGENT_KEY"

Ответ содержит ID аккаунта и баланс в копейках. Полное значение ключа видно только при создании; храните его в менеджере секретов.

Сценарий

От создания к первому запуску

  1. Проверьте баланс и доступность. Получите тарифы и вызовите GET /api/v1/projects/create-check для выбранной группы региона.
  2. Создайте проект. Выберите тариф, язык и назначение приложений. Сохраните ID и дождитесь подготовки размещения.
  3. Загрузите код и настройте запуск. Добавьте файлы, зависимости и команды в созданный проект.
  4. Наблюдайте за запуском. Выполните Deploy, опросите записи сборки и проверьте публичный адрес.

Создание снова проверяет тариф, баланс и доступность ресурсов. Сначала дождитесь результата, если запрос создания или Deploy завершился таймаутом.

Контроль доступа

Выберите минимальные права

read

Чтение тарифов, баланса и проектов, включая исходный код, логи и runtime-метаданные. Такие ключи тоже нужно хранить как секреты.

deploy

Создание проекта, загрузка кода, Deploy, запуск, остановка и перезапуск проекта или сервиса. Для чтения состояния выберите профиль «Развёртывание»: он включает read + deploy.

manage

Управление ресурсами хостинга, конфигурацией, тарифом и доступными операциями удаления. Профиль «Полный доступ» включает все три области.

Точный список методов и требуемая область указаны в OpenAPI. Запросы требуют действующего ключа; отзыв и истечение блокируют следующие запросы. Области независимы: прямой ключ с manage не получает автоматическиread или deploy. Уже принятые фоновые задачи могут завершиться, а размещённые приложения продолжают работать и тарифицироваться.

Храните ключ как пароль

Не вставляйте его в URL, исходники, логи или browser storage. API-ключ не может пополнять баланс, менять пароль или создавать другие ключи. Действия, требующие пароль аккаунта, например смену домена или просмотр env-файла, выполняет человек в кабинете. Для создания ключа нужны подтверждённый email, завершённая регистрация и принятое соглашение.

Срок действия — от 1 минуты до 365 дней или без срока до ручного отзыва. Создать ключ может владелец с подтверждённым email и принятым соглашением; в одном аккаунте может быть до 100 действующих ключей.