RUVDS API (legacy): Создать VPS и дождаться готовности

Сценарий из mcp-everything. Актуально на 2026-10-24.

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

  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 — не хватает денег.
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

Базовые URL

Авторизация

Тип: Другое

Вызовите /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/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

Нюансы

Другие сценарии

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