presets.php¶

Модуль управления пресетами: получение списков, поиск подходящих серверов, группировка и отображение информации о конфигурациях

Методы API¶

Метод	Действие	Описание
`groups`	получение групп	Возвращает список доступных групп пресетов
`info`	получение информации	Возвращает список пресетов с указанием цен в выбранных валютах
`list`	получение списка	Возвращает список всех доступных пресетов с учетом локации и прав доступа
`search`	поиск серверов	Поиск подходящих серверов по названию пресета, области видимости и локации
`show`	просмотр пресета	Возвращает детальную информацию о конкретном пресете

presets/groups¶

Возвращает список доступных групп пресетов

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `groups`
token	✅	string	Токен авторизации

Пример запроса

curl -s "https://invapi.hostkey.ru/presets.php" -X POST \
--data "action=groups" \
--data "token=HOSTKEY_TOKEN"

Пример успешного ответа

{
"result": "OK",
"action": "groups",
"data": [
{
"id": 1,
"name": "Standard Web"
},
{
"id": 2,
"name": "High Performance"
}
]
}

Примеры ошибок

{
"code": -1,
"message": "Authentication failed"
}

presets/info¶

Возвращает список пресетов с указанием цен в выбранных валютах

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `info`
currencies	❌	`array<string>`	Список валют для отображения цен. Принимает значения через запятую или в виде массива.

Пример запроса

curl -s "https://invapi.hostkey.ru/presets.php" -X POST \
--data "action=info" \
--data "currencies[]=EUR" \
--data "currencies[]=RUB"

Пример успешного ответа

{
"result": "OK",
"action": "info",
"presets": [
{
"id": 10,
"name": "Basic VPS",
"price": {
"EUR": 5.0,
"RUB": 500.0
}
}
]
}

Примеры ошибок

{
"code": -1,
"message": "Error fetching presets"
}

presets/list¶

Возвращает список всех доступных пресетов с учетом локации и прав доступа

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
token	❌	string	Токен авторизации
location	❌	string	Код локации или ID зоны для фильтрации доступных пресетов

Пример запроса

curl -s "https://invapi.hostkey.ru/presets.php" -X POST \
--data "action=list"

Пример успешного ответа

{
"result": "OK",
"action": "list",
"presets": [
{
"id": 1,
"name": "Premium Config",
"available": 0.5,
"total": 10,
"price": {
"EUR": 25.0,
"RUB": 2500.0
},
"tags": [
{
"id": 1,
"name": "ssd"
}
],
"server_type": "Instant Server"
}
]
}

Примеры ошибок

{
"code": -1,
"message": "$module/list: no presets found"
}

presets/search¶

Поиск подходящих серверов по названию пресета, области видимости и локации

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `search`
token	✅	string	Токен авторизации
name	✅	string	Название пресета для поиска серверов
scope	❌	string	Область видимости: free или all
location	❌	string	Локация (код или ID дата-центра)

Пример запроса

curl -s "https://invapi.hostkey.ru/presets.php" -X POST \
--data "action=search" \
--data "token=HOSTKEY_TOKEN" \
--data "name=VALUE"

Пример успешного ответа

{
"result": "OK",
"action": "search",
"servers": [
{
"id": 501,
"name": "Server-01",
"status": "active",
"days_left": 30,
"due_date": "2024-12-31"
}
]
}

Примеры ошибок

{
"code": -1,
"message": "Search failed"
}

presets/show¶

Возвращает детальную информацию о конкретном пресете

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `show`
token	❌	string	Токен авторизации
id	❌	integer	Идентификатор пресета для получения информации
name	❌	string	Название пресета
limit	❌	integer	Лимит записей
web_ip	❌	string	IP-адрес для веб-интерфейса или сетевой адрес.

Пример запроса

curl -s "https://invapi.hostkey.ru/presets.php" -X POST \
--data "action=show"

Пример успешного ответа

{
"result": "OK",
"action": "show",
"presets": {
"id": 123,
"name": "High CPU Preset",
"cpu": "4 Cores",
"ram": 8,
"hdd": 100,
"gpu": "None",
"locations": [
"NL",
"DE"
],
"active": true
}
}

Примеры ошибок

{
"code": -1,
"message": "JSON encode failed"
}