Serverspace.ru Public API — это публичный интерфейс программирования приложений, который позволяет взаимодействовать с сервисами и ресурсами serverspace.ru. Все действия, доступные в панели управления Serverspace, можно выполнять программно через этот API, что упрощает автоматизацию и интеграцию с внешними системами. В этой статье мы расскажем, где найти документацию по Serverspace API и как начать его использовать.
Где его найти?
Чтобы получить доступ к Serverspace.ru Public API, откройте меню «Автоматизация» в левой части панели управления и перейдите на вкладку «API»:
Для чего можно использовать Serverspace Public API
Serverspace Public API предоставляет удобный программный интерфейс для автоматизации и управления облачными ресурсами без необходимости вручную выполнять действия через веб-панель. С его помощью можно получать информацию о своих проектах, создавать и настраивать серверы, управлять сетями, дисками и другими сервисами. Это особенно полезно для разработчиков и системных администраторов, которым нужно интегрировать управление инфраструктурой в свои приложения или скрипты, а также ускорить выполнение рутинных операций.
Примеры использования
Получим информацию о проекте с помощью cURL:
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-example", ОС Debian 12 x64, 1 ГБ RAM, 1 CPU, загрузочный диск 25 ГБ SSD, 50 Мбит/с:
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"
}'
В результате возвращается ID задачи, по которой можно отслеживать процесс создания сервера:
"task_id" : "lt1507097"
}
Вывод
Использование Serverspace Public API значительно упрощает управление облачной инфраструктурой, позволяя автоматизировать рутинные задачи и интегрировать облачные сервисы в собственные приложения и рабочие процессы. Благодаря гибкому и мощному API вы можете быстро получать информацию о проектах, создавать и настраивать серверы, управлять ресурсами без необходимости работать вручную через веб-интерфейс.
Часто задаваемые вопросы (FAQ)
- В: Как получить API-ключ для работы с Serverspace Public API?
О: API-ключ можно создать в панели управления в разделе «Автоматизация» → «API». Его нужно использовать в заголовках запросов для аутентификации. - В: Какие возможности предоставляет API?
О: API позволяет управлять проектами, серверами, дисками, сетями, балансировщиками нагрузки и другими ресурсами. - В: Можно ли использовать API для массового управления ресурсами?
О: Да, API отлично подходит для автоматизации и масштабирования, позволяя создавать, изменять и удалять ресурсы программно. - В: Какие форматы данных поддерживаются?
О: Все запросы и ответы используют формат JSON.