API личного кабинета

Проверяет данные аккаунта и выдаёт API-ключ. Если на аккаунте включена TOTP-2FA: обязателен code. 2FA по email/Telegram через API не поддержана (в этом случае создайте ключ вручную выше).

Тело запроса (JSON)

Пример

curl -X POST https://my.h1cloud.net/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"login":"my@mail.tld","password":"...","name":"bot"}'

Ответ

{ "ok": true, "key": "h1_xxxxxxxx...", "prefix": "h1_xxxxxxxx" }

Список юзеров инбаунда с трафиком (up/down), лимитом и сроком.

Пример ответа

{
  "ok": true,
  "inbound_id": 1,
  "count": 2,
  "clients": [
    {
      "email": "vasya",
      "uuid": "0c7ade4b-....",
      "sub_id": "b5a16eda83270cb7",
      "enable": true,
      "total_gb": 5.0,
      "expiry_ms": 1785500000000,
      "up_bytes": 1048576,
      "down_bytes": 5242880
    }
  ]
}

Создать юзера. Возвращает готовую vless-ссылку (с рабочим обходом) и sub-ссылки: отдайте их клиенту.

Тело запроса (JSON)

Пример запроса

curl -X POST https://my.h1cloud.net/api/v1/servers/123/clients \
  -H "Authorization: Bearer h1_..." -H "Content-Type: application/json" \
  -d '{"name":"vasya","gb":50,"days":30}'

Ответ

{
  "ok": true,
  "client": {
    "email": "vasya",
    "uuid": "0c7ade4b-....",
    "sub_id": "b5a16eda83270cb7",
    "link": "vless://0c7ade4b-...@cdn.host:443?...&type=xhttp&...#vasya",
    "sub_links": ["vless://...", "vless://..."],
    "total_gb": 50.0,
    "expiry_days": 30
  }
}

Один юзер: статус, лимит, срок и израсходованный трафик (up/down в байтах).

Изменить юзера: продлить, поменять лимит трафика, включить/выключить (бан).

Тело запроса (JSON): любое из полей

Пример: забанить юзера

curl -X PATCH https://my.h1cloud.net/api/v1/servers/123/clients/vasya \
  -H "Authorization: Bearer h1_..." -H "Content-Type: application/json" \
  -d '{"enable":false}'

Удалить юзера с инбаунда. Его ссылка перестаёт работать.

Список инбаундов панели: id, remark, порт, протокол, сеть, путь и число клиентов.

Данные вашего аккаунта: Telegram-ID, никнейм, баланс и число серверов.

Пример ответа

{
  "ok": true,
  "account": {
    "tgid": 123456789,
    "username": "example_user",
    "balance": 1520.50,
    "servers_total": 3
  }
}

Все ваши серверы. Чувствительные поля (пароли панели) не отдаются, за ними идите в /config.

Пример ответа

{
  "ok": true,
  "servers": [
    {
      "id": 123,
      "name": "3x-ui (bs)",
      "tariff_id": "vpn-nl",
      "tariff_name": "Нидерланды",
      "status": "active",
      "days_left": 21,
      "expiration_date": "2026-08-03 12:00:00",
      "cpu": 100, "memory": 512, "disk": 5120,
      "vpn_bs_enabled": true,
      "xui_enabled": true,
      "remnanode_enabled": false
    }
  ]
}

Поле status: active · expired · suspended.

Подробности одного сервера: тот же объект, что и в списке.

Параметры пути

Готовый VPN-конфиг для сервера. Эндпоинт сам определяет тип и возвращает нужное: для 3x-ui: данные панели, для Remnawave (remnanode): Xray Config Profile (JSON), который вы импортируете в свою Remnawave-панель. Идемпотентно.

Пример ответа (3x-ui за CDN)

{
  "ok": true,
  "manual_client": true,
  "panel_url": "http://203.0.113.10:25214/aB3xYz9QwErT4uIo",
  "username": "u7Kp2mQx9RtL",
  "password": "eXaMpLePaSsW0rD1",
  "web_path": "aB3xYz9QwErT4uIo",
  "node_address": "203.0.113.10"
}

Создать свежий конфиг. Для 3x-ui: новый инбаунд (клиенты на старом перестанут работать). Для Remnawave (remnanode): новые reality-ключи и новый Config Profile (в ответе поле profile): импортируйте его в свою Remnawave-панель заново.

Пример ответа (remnanode)

{
  "ok": true,
  "regenerated": true,
  "kind": "remnanode",
  "profile": { "log": {...}, "inbounds": [ ... ] }
}

Live-статистика из панели: состояние (running/offline), загрузка CPU и RAM, аптайм.

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

Тело запроса (JSON)

Пример

curl -X POST https://my.h1cloud.net/api/v1/servers/123/power \
  -H "Authorization: Bearer h1_..." \
  -H "Content-Type: application/json" \
  -d '{"action":"restart"}'

Поменять версию ядра Xray сервера: то же самое, что кнопка «Поменять версию Xray (обход)» в кабинете. Версия ядра сервера должна совпадать с версией ядра Xray клиентского приложения (Happ), иначе туннель подключается, но трафик не идёт. Тело запроса: {"version": "26.6.27"}, {"version": "26.7.28"} или {"version": "26.7.11"}; без тела ставится 26.6.27.

Пример

curl -X POST https://my.h1cloud.net/api/v1/servers/123/xray-update \
  -H "Authorization: Bearer h1_..." \
  -H "Content-Type: application/json" \
  -d '{"version":"26.6.27"}'

Возможные ошибки: 503: сервер не запущен (подождите ~30 секунд), 409: на сервере нет блока пина ядра (напишите в поддержку), 502: не удалось прочитать/записать файлы сервера.

Продлить сервер на 30 дней списанием с баланса. Другие способы оплаты через API недоступны: если баланса не хватает, вернётся ошибка 400, деньги не списываются.

Пример ответа

{
  "ok": true,
  "message": "Сервер продлён на 30 дней",
  "balance": 1220.50,
  "server": { "id": 123, "days_left": 51, "...": "..." }
}