RUVDS API (legacy) API

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

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

Сценарии

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

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

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

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

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

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

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

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

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

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

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

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 часа.

Источники

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