Serverspace.ru Public API — это удобный программный интерфейс, позволяющий управлять облачными ресурсами напрямую из ваших приложений, скриптов и систем автоматизации. Всё, что вы обычно делаете через панель управления — создание серверов, управление дисками, сетями, проектами — можно выполнять автоматически, отправляя HTTP-запросы к API.
В этом материале вы узнаете, где находится документация, как получить доступ к API, а также увидите реальные примеры использования.
Где находится API и как получить доступ
Чтобы открыть настройки API, авторизуйтесь в панели Serverspace и перейдите в меню:
Автоматизация → API
Здесь вы сможете:
- создать и управлять API-ключами;
- ограничить доступ к API;
- посмотреть ссылку на официальную документацию.
API-ключ используется для аутентификации при отправке запросов — храните его в безопасном месте.
Возможности Serverspace Public API
Public API предоставляет полный контроль над инфраструктурой, позволяя выполнять те же операции, что доступны в UI, только программно. Это особенно полезно при интеграции с CI/CD, скриптами DevOps, внешними CRM или собственными панелями.
С помощью API можно:
- получать данные по проектам и аккаунтам;
- создавать, останавливать и удалять виртуальные серверы;
- управлять сетями, IP-адресами, балансировщиками;
- работать с дисковыми томами (создание, изменение, подключение);
- отслеживать состояние задач (task_id);
- автоматизировать развёртывание целой инфраструктуры.
Примеры запросов
Получение информации о проекте
curl -X GET \
https://api.serverspace.ru/api/v1/project \
-H 'content-type: application/json' \
-H 'x-api-key: lmGwbvllpIqIrKROOCLgE5Z941MKP5EYfbkgwtqJZGigfXUTpuYRpNQkCqShmm6r'Пример ответа:
{
"project": {
"balance": 400.07,
"created": "2019-04-08T10:35:53.7021047Z",
"currency": "RUB",
"id": 1,
"state": "Active"
}
}Создание сервера через API (пример)
Запрос создаёт сервер в Амстердаме с Debian 12, 1 vCPU, 1 ГБ RAM и SSD-диском 25 ГБ:
curl -X POST \
https://api.serverspace.ru/api/v1/servers \
-H 'content-type: application/json' \
-H 'x-api-key: lmGwbvllpIqIrKROOCLgE5Z941MKP5EYfbkgwtqJZGigfXUTpuYRpNQkCqShmm6r' \
-d '{
"location_id": "am2",
"image_id": "Debian-12-X64",
"cpu": 1,
"ram_mb": 1024,
"volumes": [
{
"name": "boot",
"size_mb": 25600
}
],
"networks": [
{
"bandwidth_mbps": 50
}
],
"name": "api-example"
}'API возвращает идентификатор задачи:
{
"task_id": "lt1507097"
}По этому task_id можно отслеживать прогресс создания сервера.
Шпаргалка: что можно автоматизировать через Public API
| Задача | Возможности API |
|---|---|
| Получение данных о проектах | Баланс, валюта, состояние, ID |
| Создание и управление серверами | Создание, изменение, удаление, перезапуск, мониторинг статуса |
| Работа с сетями | Настройка пропускной способности, подключение сетей, IP |
| Управление дисковыми томами | Создание, изменение размера, подключение/отключение |
| Мониторинг задач | Отслеживание статусов по task_id |
Часто задаваемые вопросы (FAQ)
- Как получить API-ключ?
Перейдите в панель Serverspace → «Автоматизация» → «API» и создайте новый ключ. Его нужно передавать в заголовке x-api-key. - Какой формат данных использует API?
Все запросы отправляются в формате JSON и возвращают ответы также в JSON. - Можно ли создавать серверы и управлять ими полностью программно?
Да. API позволяет создавать, изменять, удалять серверы, подключать диски, управлять сетями и отслеживать состояние задач. - Можно ли использовать API для массового развёртывания?
Да. Это один из основных сценариев: CI/CD, автоскейлинг, DevOps автоматизация. - Нужны ли дополнительные права или тариф для API?
Нет, API доступен всем пользователям аккаунта. Достаточно создать ключ. - Есть ли ограничения по количеству запросов?
Да, но лимиты достаточно высокие. Точные значения указаны в документации.
Итог
Serverspace Public API — мощный инструмент для автоматизации управления облаком. Он позволяет значительно ускорить рабочие процессы, упростить интеграцию с внешними сервисами и полностью контролировать инфраструктуру с помощью простых HTTP-запросов. Если вы хотите строить гибкие, масштабируемые и современные решения — API станет вашим главным помощником.
