Документация API

Аутентификация

Все запросы к API должны включать заголовок X-API-Token. Токен генерируется в панели управления.

curl -X GET 'https://api.vds-cloud.ru/v2/servers' \
  -H 'X-API-Token: your_token_here' \
  -H 'Content-Type: application/json'

Управление серверами

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

curl 'https://api.vds-cloud.ru/v2/servers?limit=50&offset=0' \
  -H 'X-API-Token: your_token_here'

Ответ:

{
  "servers": [
    {
      "id": "srv-a3b7f9",
      "name": "web-01",
      "tariff": "standard",
      "state": "running",
      "ip_addresses": ["185.24.32.111"],
      "created_at": "2026-08-01T10:23:45Z"
    }
  ],
  "meta": { "total": 12, "limit": 50, "offset": 0 }
}

POST /v2/servers — Создание сервера

curl -X POST 'https://api.vds-cloud.ru/v2/servers' \
  -H 'X-API-Token: your_token_here' \
  -d '{
    "name": "web-02",
    "tariff": "standard",
    "image": "ubuntu-24.04",
    "region": "msk-1",
    "ssh_keys": ["key-abc123"]
  }'

Доступные образы ОС

ubuntu-24.04 — Ubuntu 24.04 LTS Noble Numbat
ubuntu-22.04 — Ubuntu 22.04 LTS Jammy Jellyfish
debian-13 — Debian 13 Trixie
debian-12 — Debian 12 Bookworm
rocky-9 — Rocky Linux 9
almalinux-9 — AlmaLinux 9
fedora-40 — Fedora 40
windows-2022 — Windows Server 2022 Standard
windows-2019 — Windows Server 2019 Standard

Quickstart за 3 минуты

1. Зарегистрируйтесь и создайте API-токен в разделе Панели управления.

2. Установите CLI-утилиту:

curl -sSL https://cli.vds-cloud.ru/install.sh | bash

3. Авторизуйтесь и создайте сервер: