API · скоро

REST API QoCloud

Всё, что можно сделать в панели, можно сделать и через API: создать сервер, перезагрузить, переустановить ОС, продлить. API в разработке — формат может измениться до запуска.

Базовый адресhttps://api.qocloud.tech/v1

Авторизация

Токен из раздела «Настройки → API-ключи» в заголовке Authorization: Bearer …. Храните его как пароль.

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

Первый запрос

Сохраните токен в переменную окружения и запросите список серверов.

bash

$ export QOCLOUD_TOKEN="qc_live_…"$ curl https://api.qocloud.tech/v1/servers -H "Authorization: Bearer $QOCLOUD_TOKEN"

GET/catalog

Конфигурации и цены

Страны, конфигурации с ценами в рублях за месяц, доступные ОС и сроки оплаты.

curl

$ curl -X GET https://api.qocloud.tech/v1/catalog \  -H "Authorization: Bearer $QOCLOUD_TOKEN"

Ответ · 200

{  "locations": [    {      "code": "nl",      "name": "Нидерланды",      "available": true    }  ],  "plans": [    {      "id": "2c-4g-60",      "line": "start",      "cpu": 2,      "ram": 4,      "disk": 60,      "monthly": {        "nl": 945      }    }  ],  "os": [    "ubuntu2404",    "debian12"  ],  "periods": [    "1m",    "3m",    "6m",    "1y"  ]}

GET/servers

Список серверов

Все серверы аккаунта со статусом и сроком оплаты.

curl

$ curl -X GET https://api.qocloud.tech/v1/servers \  -H "Authorization: Bearer $QOCLOUD_TOKEN"

Ответ · 200

{  "servers": [    {      "id": "srv-1042",      "name": "web-01",      "status": "running",      "plan": "2c-4g-60",      "location": "nl",      "ip": "203.0.113.10",      "paid_until": "2026-12-02"    }  ]}

POST/servers

Создать сервер

Создаёт сервер и списывает стоимость срока с баланса. Пароль root придёт на почту, если не передать ssh_keys.

Параметры
Параметр	Описание
`plan`string · обязательный	id конфигурации из /catalog
`location`string · обязательный	код страны: nl, de, pl, ee
`os`string · обязательный	образ из /catalog
`period`string · обязательный	1m, 3m, 6m или 1y
`name`string · обязательный	латиница, цифры и дефис, до 60 символов
`ssh_keys`string[]	имена SSH-ключей из настроек

curl

$ curl -X POST https://api.qocloud.tech/v1/servers \  -H "Authorization: Bearer $QOCLOUD_TOKEN" \  -H "Content-Type: application/json" \  -d '{"plan":"2c-4g-60","location":"nl","os":"ubuntu2404","period":"1m","name":"web-02","ssh_keys":["macbook"]}'

Ответ · 200

{  "id": "srv-1077",  "status": "installing",  "charged": 945}

GET/servers/{id}

Сервер

Подробности о сервере, включая текущий статус питания.

Параметры
Параметр	Описание
`id`string · обязательный	id сервера

curl

$ curl -X GET https://api.qocloud.tech/v1/servers/srv-1042 \  -H "Authorization: Bearer $QOCLOUD_TOKEN"

Ответ · 200

{  "id": "srv-1042",  "name": "web-01",  "status": "running",  "plan": "2c-4g-60",  "location": "nl",  "os": "ubuntu2404",  "ip": "203.0.113.10",  "paid_until": "2026-12-02"}

POST/servers/{id}/actions/{action}

Действие с сервером

Запуск, остановка, перезагрузка, переустановка ОС, смена IP или продление. Операции асинхронные — статус меняется через несколько секунд.

Параметры
Параметр	Описание
`action`string · обязательный	start, stop, reboot, reinstall, change-ip, renew
`os`string	только для reinstall
`period`string	только для renew

curl

$ curl -X POST https://api.qocloud.tech/v1/servers/srv-1042/actions/reinstall \  -H "Authorization: Bearer $QOCLOUD_TOKEN" \  -H "Content-Type: application/json" \  -d '{"os":"debian12"}'

Ответ · 200

{  "id": "srv-1042",  "status": "installing"}

DELETE/servers/{id}

Удалить сервер

Удаляет сервер и все данные на нём. Действие необратимо.

curl

$ curl -X DELETE https://api.qocloud.tech/v1/servers/srv-1042 \  -H "Authorization: Bearer $QOCLOUD_TOKEN"

Ответ · 200

{  "id": "srv-1042",  "status": "deleted"}

GET/balance

Баланс

Текущий баланс и расходы в месяц.

curl

$ curl -X GET https://api.qocloud.tech/v1/balance \  -H "Authorization: Bearer $QOCLOUD_TOKEN"

Ответ · 200

{  "balance": 4820,  "currency": "RUB",  "monthly_spend": 6241}