Список API ключей
API ключи для доступа к вашему проекту.
API
Serverspace Public API - публичный API для взаимодействия с услугами Serverspace. Действия, выполняемые в панели управления Serverspace, также могут быть выполнены с помощью публичного API.
Авторизация
Для работы с публичным API создайте API-ключ для проекта и передавайте его при каждом запросе в заголовке X-API-KEY. Например, при использовании утилиты cURL, заголовок будет выглядеть следующим образом:
Все запросы API необходимо выполнять через протокол HTTPS, эндпоинт публичного API находится по следующему URL:
Примеры использования
Получим информацию о проекте, для этого отправим запрос, воспользовавшись утилитой cURL:
curl -X GET \
https://api.serverspace.io/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": "EUR",
"id": 1,
"state": "Active"
}
}
Создадим сервер со следующей конфигурацией: Амстердам, название “api-example”, операционная система Debian 10.7, конфигурация сервера 1 ГБ RAM, 1 CPU, загрузочный диск 25 ГБ SSD, 50 Мбит/с:
curl -X POST \
https://api.serverspace.io/api/v1/servers \
-H 'content-type: application/json' \
-H 'x-api-key: lmGwbvllpIqIrKROOCLgE5Z941MKP5EYfbkgwtqJZGigfXUTpuYRpNQkCqShmm6r' \
-d '{
"location_id": "am2",
"image_id": "Debian-10.7-X64",
"cpu": 1,
"ram_mb": 1024,
"volumes": [
{
"name": "boot",
"size_mb": 25600
}
],
"networks": [
{
"bandwidth_mbps": 50
}
],
"name": "api-example"
}'
В результате возвращается ID задачи, по которой можно отследить процесс создания сервера:
"task_id" : "lt1507097"
}