Void API — твои домены, серверы и хостинг по REST.

Что можно заказать прямо сейчас. os[].code и apps[].code идут в заказ; в custom — лимиты конфигуратора, причём max уже учитывает, сколько ещё может взять самый свободный узел; periods — множители цены относительно месяца (скидки за срок уже внутри); proxy — можно ли сейчас заказать фронт-прокси. plans — фиксированные тарифы бота, для справки: API заказывает по spec.

{ "ok": true, "data": {
    "plans":   [ { "code": "…", "nameEn": "…", "nameRu": "…", "vcpu": 1, "ramMb": 1024, "diskGb": 20, "trafficGb": null, "bandwidthMbps": …,
                   "prices": { "MONTH": "…", "QUARTER": "…", "HALF_YEAR": "…", "YEAR": "…" } }, … ],
    "os":      [ { "code": "ubuntu-24", "name": "Ubuntu 24.04" }, { "code": "windows-2022", "name": "Windows Server 2022" }, … ],
    "apps":    [ { "code": "3x-ui", "name": "3x-ui", "descEn": "…", "descRu": "…", "baseOs": "ubuntu-24", "minRamMb": 1024, "minutes": 2 }, … ],
    "regions": ["PL"],
    "custom":  { "cpu":    { "min": 1,  "max": 16,   "step": 1,  "monthly": 1.25 },
                 "ramGb":  { "min": 1,  "max": 64,   "step": 1,  "monthly": 1.5 },
                 "diskGb": { "min": 20, "max": 1000, "step": 20, "monthlyPer10Gb": 0.25 },
                 "base": { "monthly": 3 }, "defaults": { "vcpu": 2, "ramGb": 4, "diskGb": 80 } },
    "periods": { "MONTH": 1, "QUARTER": 2.925, "HALF_YEAR": 5.7, "YEAR": 11.1 },
    "proxy":   { "available": true, "monthly": 3, "free": 12, "total": 16 } } }

Ставки в custom и proxy — обычные числа, USD в месяц; значения выше — пример, бери их из ответа. Цена в месяц = base + vcpu × cpu.monthly + ramGb × ramGb.monthly + diskGb / 10 × monthlyPer10Gb (+ proxy.monthly с прокси); цена срока = месячная × periods[срок], с округлением до центов. Точная оплаченная сумма — periodPrice в ответе на заказ.

Твои серверы, новые первыми, без удалённых. Не больше 50 на страницу.

{ "ok": true, "data": { "items": [ Server, … ], "total": 2, "offset": 0, "limit": 20 } }

Списывает первый срок, резервирует мощность и IPv4-адрес и ставит создание в очередь. Возвращает сервер в PENDING. Считается в лимит 20 / мин.

{ "spec": { "vcpu": 2, "ramGb": 4, "diskGb": 80 }, "os": "ubuntu-24", "period": "QUARTER", "region": "PL" }
{ "spec": { "vcpu": 2, "ramGb": 2, "diskGb": 40 }, "app": "3x-ui", "period": "MONTH" }

Не идемпотентно: каждый успешный вызов — ещё один оплаченный сервер. После таймаута сначала посмотри GET /servers, потом повторяй. Если создать сервер так и не удалось, он переходит в FAILED, а первый срок возвращается на баланс.

Один сервер — см. Server. У предустановленного приложения app.state идёт PENDING → INSTALLING → READY (или FAILED) уже после того, как сам сервер стал ACTIVE; app.url и app.note появляются, когда оно готово. power обновляется периодически и может немного отставать от действия.

Единственное место, где отдаются секреты. login — root, на Windows — Administrator; app добавляет адрес панели, логин и пароль предустановленного приложения, когда оно READY. Обращайся с ответом как с самим API-ключом — не пиши его в логи.

{ "ok": true, "data": { "ip": "203.0.113.25", "login": "root", "password": "…", "app": null } }

// с приложением:
{ "ok": true, "data": { "ip": "203.0.113.25", "login": "root", "password": "…",
    "app": { "code": "3x-ui", "name": "3x-ui", "state": "READY", "url": "https://…", "login": "…", "password": "…" } } }

Передавай только то, что меняешь; возвращает сервер.

{ "autoRenew": true, "alias": "api-prod" }

Ставит действие в очередь и сразу отвечает { "queued": true }; результат смотри в GET /servers/{id}.

{ "action": "reboot" }
{ "action": "reinstall", "os": "ubuntu-24" }

reinstall стирает диск. Сервер заново клонируется из чистого образа — того же, если не передан ни os, ни app. IP-адрес, размер и пароль сохраняются (образу Windows может понадобиться пароль сложнее — перечитай /credentials), правила файрвола применяются заново. Выбрать можно только образы, доступные на узле сервера, иначе 400 NO_TEMPLATE.

Сразу списывает periodPrice и продлевает expiresAt на один срок — от более поздней из дат: текущего истечения или сейчас, так что раннее продление не съедает оплаченное время. Приостановленный (SUSPENDED) сервер запускается снова. Каждый успешный вызов добавляет ещё один срок. Возвращает сервер.

Все сроки продления с ценой по сегодняшним ставкам; current отмечает текущий срок сервера.

{ "ok": true, "data": [ { "period": "MONTH", "price": "13.50", "current": true }, { "period": "QUARTER", "price": "39.49", "current": false },
                        { "period": "HALF_YEAR", "price": "76.95", "current": false }, { "period": "YEAR", "price": "149.85", "current": false } ] }

{ "period": "YEAR" } — меняет срок продления. Сейчас ничего не списывается, и текущий expiresAt не сдвигается: следующее продление, автоматическое или ручное, спишет цену нового срока и продлит на новый срок. Возвращает тот же список, что и GET. Только для ACTIVE / SUSPENDED.

{ "spec": { "vcpu", "ramGb", "diskGb" } } — сколько стоит апгрейд до этого размера. Апгрейд только вверх: каждое значение не меньше текущего, хотя бы одно больше, в пределах конфигуратора (уменьшение — через поддержку). charge списывается сейчас: разница цены срока пропорционально остатку оплаченного срока — (новая periodPrice − старая periodPrice) × остаток / длина срока. periodPrice — сколько будет стоить каждое продление после апгрейда.

{ "spec": { "vcpu": 4, "ramGb": 8, "diskGb": 80 } }

{ "ok": true, "data": { "serverId": "3b0c…", "from": { "vcpu": 2, "ramGb": 4, "diskGb": 80 }, "to": { "vcpu": 4, "ramGb": 8, "diskGb": 80 },
    "charge": "5.48", "periodPrice": "22.00", "period": "MONTH", "expiresAt": "2026-12-01T10:00:00.000Z" } }

Сразу списывает сумму из квоты и ставит изменение размера в очередь; возвращает применённую квоту. Новые CPU и память вступают в силу через перезапуск — работающий сервер перезагружается, будь готов к короткому простою. Виртуальный диск увеличивается на месте; если гостевая ОС не расширяет раздел при загрузке, расширь его сам.

{ "spec": { "vcpu": 4, "ramGb": 8, "diskGb": 80 }, "maxCharge": "5.48" }

// цена стала выше maxCharge: ничего не списано, свежая квота — в details
{ "ok": false, "error": { "code": "UPGRADE_PRICE_CHANGED", "message": "…",
    "details": { "serverId": "3b0c…", "from": { … }, "to": { … }, "charge": "5.60", "periodPrice": "22.00", "period": "MONTH", "expiresAt": "…" } } }

{ "enabled": true | false } — включить или выключить allow-list; правила сохраняются в обоих случаях. Возвращает файрвол.

{ "rule": "3306 from 1.2.3.4" } — добавляет одно правило в синтаксисе выше и возвращает весь файрвол. Если такое правило уже есть, ничего не меняется.

Удаляет правило на этой позиции в rules (с нуля) и возвращает файрвол. После удаления позиции сдвигаются — перечитай список, прежде чем удалять следующее. 404 NOT_FOUND, если такой позиции нет.