{"name":"RUVDS API (legacy)","vendor":"RUVDS","industry":"cloud","summary":"HTTP API VPS-хостинга RUVDS: сессионный токен, баланс, дата-центры, тарифы, операционные системы, список серверов, создание сервера, изменение конфигурации и периода оплаты, команды (запуск, остановка, перезагрузка, пересоздание, удаление), статистика и скриншот экрана. Важно: это прежняя версия API — по словам RUVDS, она больше не обновляется и не поддерживается; документация актуальной API v2 — на `https://ruvds.com/api-docs`.","docsUrl":"https://ruvds.com/en-rub/use_api","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"sozdat-vps-i-dozhdatsya-gotovnosti","title":"Создать VPS и дождаться готовности","summary":"Заказать сервер из скрипта: дата-центр, тариф, ОС и диск.","steps":["Это прежняя версия 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 — не хватает денег."],"code":"TOKEN=$(curl -s -G https://ruvds.com/api/logon/ -d key=<ключ> --data-urlencode 'username=<логин>' --data-urlencode 'password=<пароль>' -d endless=0 | jq -r .sessionToken)\n\ncurl -G https://ruvds.com/api/server/create/ -d sessionToken=$TOKEN \\\n  -d datacenter=1 -d tariff=14 -d os=15 -d cpu=2 -d ram=4 -d vram=0 \\\n  -d drivesCount=1 -d drive0Tariff=1 -d drive0Capacity=40 -d drive0System=true \\\n  -d ip=1 -d paymentPeriod=2 -d computerName=web-1042","language":"bash","methods":["GET /api/logon/","GET /api/datacenter/","GET /api/tariff/","GET /api/os/","GET /api/servers/","GET /api/server/create/"]},{"id":"perezapustit-ili-vyklyuchit-server","title":"Перезапустить или выключить сервер","summary":"Управление серверами из своей панели или мониторинга.","steps":["Отправь команду: 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/."],"code":"curl -G https://ruvds.com/api/server/command/ -d sessionToken=$TOKEN -d id=38420 -d type=reset\ncurl -G https://ruvds.com/api/servers/ -d sessionToken=$TOKEN -d id=38420 -d fields=state,running,ip","language":"bash","methods":["GET /api/servers/","GET /api/server/command/","GET /api/server/stat/","GET /api/server/image/"]},{"id":"sledit-za-balansom-i-oplatoy-serverov","title":"Следить за балансом и оплатой серверов","summary":"Не допустить отключения серверов из-за нехватки денег.","steps":["Запроси баланс: GET /api/balance/ — amount и currency; с details = 1 — история пополнений и списаний.","Узнай, до какого числа оплачены серверы: GET /api/servers/ — поля paid и paidTill.","Чтобы платить реже, поменяй период оплаты: GET /api/server/update/payment_period/ с id и paymentPeriod (3 — 3 месяца, 4 — полгода, 5 — год). Новый период начнётся после текущего."],"code":"curl -G https://ruvds.com/api/balance/ -d sessionToken=$TOKEN -d details=0\ncurl -G https://ruvds.com/api/servers/ -d sessionToken=$TOKEN -d fields=paid,paidTill,paymentPeriod","language":"bash","methods":["GET /api/balance/","GET /api/servers/","GET /api/server/update/payment_period/"]}],"baseUrls":[{"label":"Боевой","url":"https://ruvds.com"}],"auth":{"type":"other","description":"Вызовите `/api/logon/` с персональным ключом API (`key` из настроек аккаунта), логином и паролем; полученный `sessionToken` передавайте параметром во всех последующих запросах. Токен храните только на своём сервере. Смена логина или пароля деактивирует все выданные токены.","example":"https://ruvds.com/api/logon/?key=KEY&username=LOGIN&password=PASSWORD&endless=0"},"methods":[{"id":"GET /api/logon/","title":"Получение сессионного токена","httpMethod":"GET","path":"/api/logon/","description":"В ответе: `sessionToken`, `expire` (ddMMyyyyHHmmss UTC или NULL для бессрочного).","params":[{"name":"key","in":"query","type":"string","required":true,"description":"Персональный ключ API"},{"name":"username","in":"query","type":"string","required":true,"description":"Логин или email"},{"name":"password","in":"query","type":"string","required":true,"description":"Пароль"},{"name":"endless","in":"query","type":"integer","required":false,"description":"1 — бессрочный токен, 0 — на 24 часа"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/balance/","title":"Баланс","httpMethod":"GET","path":"/api/balance/","description":"В ответе: `amount`, `currency` (1 RUB, 2 UAH, 3 USD, 4 EUR), при `details=1` — история (`income`, `debited`, `items`).","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"details","in":"query","type":"integer","required":false,"description":"1 — с историей платежей"}],"requestExample":"https://ruvds.com/api/balance/?sessionToken=YOURTOKEN&details=0","responseExample":"","docsUrl":""},{"id":"GET /api/datacenter/","title":"Дата-центры","httpMethod":"GET","path":"/api/datacenter/","description":"В ответе `datacenters`: `id`, `name`, `tariffs`, `driveTariffCombinations`.","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"language","in":"query","type":"integer","required":false,"description":"1 — русский, 5 — английский, 6 — немецкий"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/tariff/","title":"Тарифы","httpMethod":"GET","path":"/api/tariff/","description":"Цены серверов — за ядро, ГБ ОЗУ, МБ видеопамяти и доп. IP; дисков — за ГБ.","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"tariffIds","in":"query","type":"string","required":false,"description":"ID тарифов серверов через запятую (включая устаревшие)"},{"name":"driveTariffIds","in":"query","type":"string","required":false,"description":"ID тарифов дисков через запятую"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/os/","title":"Операционные системы","httpMethod":"GET","path":"/api/os/","description":"В ответе `os[]`: `Id`, `Name`.","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/servers/","title":"Список серверов","httpMethod":"GET","path":"/api/servers/","description":"В `items`: `cpu`, `ram`, `vram`, `drive`, `ip`, `tariff`, `paymentPeriod`, `state`, `running`, `paid`, `paidTill`, `stat`, `configurationChangeable` и др.","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"id","in":"query","type":"string","required":false,"description":"ID серверов через запятую (рекомендуется указывать)"},{"name":"fields","in":"query","type":"string","required":false,"description":"Какие поля вернуть; пусто — все"},{"name":"userId","in":"query","type":"string","required":false,"description":"ID пользователя"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/server/create/","title":"Создание сервера","httpMethod":"GET","path":"/api/server/create/","description":"Создание асинхронное: в ответе `id` и `cost`, ход — через `/api/servers/`.","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"datacenter","in":"query","type":"integer","required":true,"description":"ID дата-центра"},{"name":"tariff","in":"query","type":"integer","required":true,"description":"ID тарифа сервера"},{"name":"os","in":"query","type":"integer","required":false,"description":"ID ОС"},{"name":"cpu","in":"query","type":"integer","required":true,"description":"Число ядер"},{"name":"ram","in":"query","type":"integer","required":true,"description":"ОЗУ, ГБ"},{"name":"vram","in":"query","type":"integer","required":true,"description":"Видеопамять, МБ: 0, 64, 128, 256, 512, 1024"},{"name":"drivesCount","in":"query","type":"integer","required":true,"description":"Число дисков"},{"name":"drive0Tariff","in":"query","type":"integer","required":true,"description":"ID тарифа диска (для каждого X от 0)"},{"name":"drive0Capacity","in":"query","type":"integer","required":true,"description":"Размер диска, ГБ"},{"name":"drive0System","in":"query","type":"boolean","required":true,"description":"Системный диск"},{"name":"ip","in":"query","type":"integer","required":true,"description":"Число IP-адресов"},{"name":"ddosProtection","in":"query","type":"number","required":false,"description":"Полоса защиты от DDoS, Мбит/с, шаг 0.5"},{"name":"paymentPeriod","in":"query","type":"integer","required":true,"description":"2 — месяц, 3 — 3 месяца, 4 — 6 месяцев, 5 — год"},{"name":"promocode","in":"query","type":"string","required":false,"description":"Промокод"},{"name":"computerName","in":"query","type":"string","required":false,"description":"Имя сервера"},{"name":"userComment","in":"query","type":"string","required":false,"description":"Комментарий"}],"requestExample":"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","responseExample":"","docsUrl":""},{"id":"GET /api/server/update/configuration/","title":"Изменение конфигурации","httpMethod":"GET","path":"/api/server/update/configuration/","description":"Асинхронно: следите за `configurationUpdating` в `/api/servers/`.","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"id","in":"query","type":"integer","required":true,"description":"ID сервера"},{"name":"cpu","in":"query","type":"integer","required":true,"description":"Ядра"},{"name":"ram","in":"query","type":"integer","required":true,"description":"ОЗУ, ГБ"},{"name":"vram","in":"query","type":"integer","required":true,"description":"Видеопамять, МБ"},{"name":"drive","in":"query","type":"integer","required":true,"description":"Диск, ГБ"},{"name":"ip","in":"query","type":"integer","required":true,"description":"Число IP"},{"name":"ddosProtection","in":"query","type":"number","required":false,"description":"Полоса защиты от DDoS"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/server/update/payment_period/","title":"Смена периода оплаты","httpMethod":"GET","path":"/api/server/update/payment_period/","description":"Применяется по окончании текущего периода.","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"id","in":"query","type":"integer","required":true,"description":"ID сервера"},{"name":"paymentPeriod","in":"query","type":"integer","required":true,"description":"2, 3, 4 или 5"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/server/command/","title":"Команда серверу","httpMethod":"GET","path":"/api/server/command/","description":"Выполняется сразу (кроме асинхронного `recreate`).","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"id","in":"query","type":"integer","required":true,"description":"ID сервера"},{"name":"type","in":"query","type":"string","required":true,"description":"start, stop, shutdown, reset, new_password, recreate, remove"}],"requestExample":"https://ruvds.com/api/server/command/?sessionToken=YOURTOKEN&id=38420&type=start","responseExample":"","docsUrl":""},{"id":"GET /api/server/stat/","title":"Статистика ресурсов","httpMethod":"GET","path":"/api/server/stat/","description":"Посуточно: `cpu.avgLoad`, `drive` (`read`, `write`, `avgIOPS`), `traffic` (`inbound`, `outbound`).","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"id","in":"query","type":"integer","required":true,"description":"ID сервера (один)"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/server/image/","title":"Скриншот экрана","httpMethod":"GET","path":"/api/server/image/","description":"`imageBase64` — null, если сервер не в состоянии 100 или не запущен.","params":[{"name":"sessionToken","in":"query","type":"string","required":true,"description":"Сессионный токен"},{"name":"id","in":"query","type":"integer","required":true,"description":"ID сервера"},{"name":"width","in":"query","type":"integer","required":true,"description":"64–640"},{"name":"height","in":"query","type":"integer","required":true,"description":"48–480"}],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"0","description":"Успех"},{"code":"1","description":"Неверный токен"},{"code":"2","description":"Токен не указан"},{"code":"4","description":"Сервер не найден"},{"code":"19","description":"Недостаточно средств (создание, изменение)"},{"code":"100","description":"Внутренняя ошибка"}],"limits":"- Скриншот кешируется — не чаще раза в 10 секунд.\n- Создание и удаление больше 10 серверов за сутки может временно заблокировать создание новых.\n- Токен без `endless=1` действует 24 часа.","gotchas":["Запросы GET или POST, параметры — в строке запроса; ответы — JSON.","В каждом ответе `rejectReason` (`0` — успех) и `errMessage`; коды ошибок свои у каждого метода.","Методы управления пользователями (`/api/user/...`) отключены и доступны только юрлицам с партнёрским договором.","Для тестов документация советует SSD-серверы и минимум запросов."],"slug":"ruvds","version":2,"updatedAt":"2026-10-24T17:05:36.168Z","sources":[{"title":"RUVDS API — начало работы","url":"https://ruvds.com/en-rub/use_api","kind":"research","addedAt":"2026-10-19T13:54:20.260Z"},{"title":"RUVDS API — серверы","url":"https://ruvds.com/en-usd/use_api/server","kind":"research","addedAt":"2026-10-19T13:54:20.260Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-19T13:54:20.260Z"},{"title":"scenarios-ruvds.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:26.660Z"}],"logoUrl":null}