---
slug: "ruvds"
name: "RUVDS API (legacy)"
vendor: "RUVDS"
industry: "cloud"
docsUrl: "https://ruvds.com/en-rub/use_api"
version: 2
updatedAt: "2026-10-24"
---

# RUVDS API (legacy)

Отрасль: Облака и хостинг. Актуально на 2026-10-24.

HTTP API VPS-хостинга RUVDS: сессионный токен, баланс, дата-центры, тарифы, операционные системы, список серверов, создание сервера, изменение конфигурации и периода оплаты, команды (запуск, остановка, перезагрузка, пересоздание, удаление), статистика и скриншот экрана. Важно: это прежняя версия API — по словам RUVDS, она больше не обновляется и не поддерживается; документация актуальной API v2 — на `https://ruvds.com/api-docs`.

## Сценарии

### Создать VPS и дождаться готовности

Заказать сервер из скрипта: дата-центр, тариф, ОС и диск.

1. Это прежняя версия API — RUVDS её больше не развивает; для новых интеграций смотри документацию API v2. Ниже — как работает legacy.
2. Получи токен: GET /api/logon/ с key (персональный ключ из настроек), username и password. endless = 1 даёт бессрочный токен, 0 — на 24 часа. Смена логина или пароля отзывает все токены.
3. Выбери параметры: GET /api/datacenter/ (дата-центры и тарифы), GET /api/tariff/ (цены за ядро, ГБ ОЗУ и диска), GET /api/os/ (операционные системы).
4. Создай сервер: GET /api/server/create/ с sessionToken, datacenter, tariff, os, cpu, ram, vram, drivesCount, drive0Tariff, drive0Capacity, drive0System, ip и paymentPeriod (2 — месяц). В ответе id и cost.
5. Создание асинхронное — следи за state и running через GET /api/servers/ с id. В каждом ответе rejectReason = 0 означает успех, 19 — не хватает денег.

```bash
TOKEN=$(curl -s -G https://ruvds.com/api/logon/ -d key=<ключ> --data-urlencode 'username=<логин>' --data-urlencode 'password=<пароль>' -d endless=0 | jq -r .sessionToken)

curl -G https://ruvds.com/api/server/create/ -d sessionToken=$TOKEN \
  -d datacenter=1 -d tariff=14 -d os=15 -d cpu=2 -d ram=4 -d vram=0 \
  -d drivesCount=1 -d drive0Tariff=1 -d drive0Capacity=40 -d drive0System=true \
  -d ip=1 -d paymentPeriod=2 -d computerName=web-1042
```

### Перезапустить или выключить сервер

Управление серверами из своей панели или мониторинга.

1. Отправь команду: GET /api/server/command/ с id сервера и type — start, stop, shutdown (мягкое выключение), reset или recreate. Команды выполняются сразу, кроме асинхронного recreate.
2. Проверь состояние: GET /api/servers/ с id — поля state и running.
3. Если сервер не отвечает, посмотри экран: GET /api/server/image/ с width и height — в imageBase64 скриншот консоли (не чаще раза в 10 секунд).
4. Посуточная нагрузка процессора, дисков и трафик — GET /api/server/stat/.

```bash
curl -G https://ruvds.com/api/server/command/ -d sessionToken=$TOKEN -d id=38420 -d type=reset
curl -G https://ruvds.com/api/servers/ -d sessionToken=$TOKEN -d id=38420 -d fields=state,running,ip
```

### Следить за балансом и оплатой серверов

Не допустить отключения серверов из-за нехватки денег.

1. Запроси баланс: GET /api/balance/ — amount и currency; с details = 1 — история пополнений и списаний.
2. Узнай, до какого числа оплачены серверы: GET /api/servers/ — поля paid и paidTill.
3. Чтобы платить реже, поменяй период оплаты: GET /api/server/update/payment_period/ с id и paymentPeriod (3 — 3 месяца, 4 — полгода, 5 — год). Новый период начнётся после текущего.

```bash
curl -G https://ruvds.com/api/balance/ -d sessionToken=$TOKEN -d details=0
curl -G https://ruvds.com/api/servers/ -d sessionToken=$TOKEN -d fields=paid,paidTill,paymentPeriod
```

## Базовые URL

- Боевой: `https://ruvds.com`

## Авторизация

Тип: Другое

Вызовите `/api/logon/` с персональным ключом API (`key` из настроек аккаунта), логином и паролем; полученный `sessionToken` передавайте параметром во всех последующих запросах. Токен храните только на своём сервере. Смена логина или пароля деактивирует все выданные токены.

```
https://ruvds.com/api/logon/?key=KEY&username=LOGIN&password=PASSWORD&endless=0
```

## Методы

### GET /api/logon/ — Получение сессионного токена

В ответе: `sessionToken`, `expire` (ddMMyyyyHHmmss UTC или NULL для бессрочного).

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `key` | query | string | да | Персональный ключ API |
| `username` | query | string | да | Логин или email |
| `password` | query | string | да | Пароль |
| `endless` | query | integer | нет | 1 — бессрочный токен, 0 — на 24 часа |

### GET /api/balance/ — Баланс

В ответе: `amount`, `currency` (1 RUB, 2 UAH, 3 USD, 4 EUR), при `details=1` — история (`income`, `debited`, `items`).

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `details` | query | integer | нет | 1 — с историей платежей |

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

```
https://ruvds.com/api/balance/?sessionToken=YOURTOKEN&details=0
```

### GET /api/datacenter/ — Дата-центры

В ответе `datacenters`: `id`, `name`, `tariffs`, `driveTariffCombinations`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `language` | query | integer | нет | 1 — русский, 5 — английский, 6 — немецкий |

### GET /api/tariff/ — Тарифы

Цены серверов — за ядро, ГБ ОЗУ, МБ видеопамяти и доп. IP; дисков — за ГБ.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `tariffIds` | query | string | нет | ID тарифов серверов через запятую (включая устаревшие) |
| `driveTariffIds` | query | string | нет | ID тарифов дисков через запятую |

### GET /api/os/ — Операционные системы

В ответе `os[]`: `Id`, `Name`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |

### GET /api/servers/ — Список серверов

В `items`: `cpu`, `ram`, `vram`, `drive`, `ip`, `tariff`, `paymentPeriod`, `state`, `running`, `paid`, `paidTill`, `stat`, `configurationChangeable` и др.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `id` | query | string | нет | ID серверов через запятую (рекомендуется указывать) |
| `fields` | query | string | нет | Какие поля вернуть; пусто — все |
| `userId` | query | string | нет | ID пользователя |

### GET /api/server/create/ — Создание сервера

Создание асинхронное: в ответе `id` и `cost`, ход — через `/api/servers/`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `datacenter` | query | integer | да | ID дата-центра |
| `tariff` | query | integer | да | ID тарифа сервера |
| `os` | query | integer | нет | ID ОС |
| `cpu` | query | integer | да | Число ядер |
| `ram` | query | integer | да | ОЗУ, ГБ |
| `vram` | query | integer | да | Видеопамять, МБ: 0, 64, 128, 256, 512, 1024 |
| `drivesCount` | query | integer | да | Число дисков |
| `drive0Tariff` | query | integer | да | ID тарифа диска (для каждого X от 0) |
| `drive0Capacity` | query | integer | да | Размер диска, ГБ |
| `drive0System` | query | boolean | да | Системный диск |
| `ip` | query | integer | да | Число IP-адресов |
| `ddosProtection` | query | number | нет | Полоса защиты от DDoS, Мбит/с, шаг 0.5 |
| `paymentPeriod` | query | integer | да | 2 — месяц, 3 — 3 месяца, 4 — 6 месяцев, 5 — год |
| `promocode` | query | string | нет | Промокод |
| `computerName` | query | string | нет | Имя сервера |
| `userComment` | query | string | нет | Комментарий |

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

```
https://ruvds.com/api/server/create/?sessionToken=YOURTOKEN&datacenter=1&tariff=14&os=15&cpu=2&ram=4&vram=0&drivesCount=1&drive0Tariff=1&drive0Capacity=40&drive0System=true&ip=1&ddosProtection=0&paymentPeriod=2&promocode=PROMO-API&computerName=CustomVDS
```

### GET /api/server/update/configuration/ — Изменение конфигурации

Асинхронно: следите за `configurationUpdating` в `/api/servers/`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `id` | query | integer | да | ID сервера |
| `cpu` | query | integer | да | Ядра |
| `ram` | query | integer | да | ОЗУ, ГБ |
| `vram` | query | integer | да | Видеопамять, МБ |
| `drive` | query | integer | да | Диск, ГБ |
| `ip` | query | integer | да | Число IP |
| `ddosProtection` | query | number | нет | Полоса защиты от DDoS |

### GET /api/server/update/payment_period/ — Смена периода оплаты

Применяется по окончании текущего периода.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `id` | query | integer | да | ID сервера |
| `paymentPeriod` | query | integer | да | 2, 3, 4 или 5 |

### GET /api/server/command/ — Команда серверу

Выполняется сразу (кроме асинхронного `recreate`).

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `id` | query | integer | да | ID сервера |
| `type` | query | string | да | start, stop, shutdown, reset, new_password, recreate, remove |

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

```
https://ruvds.com/api/server/command/?sessionToken=YOURTOKEN&id=38420&type=start
```

### GET /api/server/stat/ — Статистика ресурсов

Посуточно: `cpu.avgLoad`, `drive` (`read`, `write`, `avgIOPS`), `traffic` (`inbound`, `outbound`).

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `id` | query | integer | да | ID сервера (один) |

### GET /api/server/image/ — Скриншот экрана

`imageBase64` — null, если сервер не в состоянии 100 или не запущен.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `id` | query | integer | да | ID сервера |
| `width` | query | integer | да | 64–640 |
| `height` | query | integer | да | 48–480 |

## Нюансы

- Запросы GET или POST, параметры — в строке запроса; ответы — JSON.
- В каждом ответе `rejectReason` (`0` — успех) и `errMessage`; коды ошибок свои у каждого метода.
- Методы управления пользователями (`/api/user/...`) отключены и доступны только юрлицам с партнёрским договором.
- Для тестов документация советует SSD-серверы и минимум запросов.

## Ошибки

| Код | Описание |
|---|---|
| `0` | Успех |
| `1` | Неверный токен |
| `2` | Токен не указан |
| `4` | Сервер не найден |
| `19` | Недостаточно средств (создание, изменение) |
| `100` | Внутренняя ошибка |

## Ограничения

- Скриншот кешируется — не чаще раза в 10 секунд.
- Создание и удаление больше 10 серверов за сутки может временно заблокировать создание новых.
- Токен без `endless=1` действует 24 часа.

## Источники

- [RUVDS API — начало работы](https://ruvds.com/en-rub/use_api)
- [RUVDS API — серверы](https://ruvds.com/en-usd/use_api/server)

---

Если этого недостаточно — официальная документация: https://ruvds.com/en-rub/use_api
JSON: https://mcp-everything.ru/api/integrations/ruvds. MCP: https://mcp-everything.ru/mcp