presets.php¶

Модуль управления пресетами серверов: получение списков, группировка, поиск подходящих серверов и детализация конфигураций с ценами в разных валютах.

Методы API¶

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

presets/groups¶

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

HTTP-метод: POST|GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Действие (groups)
token	❌	string	Токен авторизации

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

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

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

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

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

``` { "code": -1, "message": "presets: action required" }

```

presets/info¶

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

HTTP-метод: POST|GET

Параметры:

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

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

curl -s "https://invapi.hostkey.ru/presets.php" -X POST \
--data "action=info&id=123"

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

{
"result": "OK",
"action": "info",
"data": {
"tags": []
}
}

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

``` { "code": 0, "message": "Action required" }

```

presets/list¶

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

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "list",
"presets": [
{
"Code": "NL",
"amount": 10,
"available": 5,
"component_id": 123,
"price": {
"EUR": 49.99,
"USD": 54.99
},
"server_type": "Instant Server",
"tags": [
{
"id": 1,
"name": "high-performance"
}
],
"total": 20
}
]
}

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

``` { "code": -1, "message": "presets/list error: no presets found" }

```

presets/search¶

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

HTTP-метод: POST|GET

Параметры:

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

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

curl -s "https://invapi.hostkey.ru/presets.php" -X POST \
--data "action=search" \
--data "token=YOUR_TOKEN" \
--data "name=my_preset" \
--data "location=123"

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

{
"result": "OK",
"action": "search",
"servers": [
{
"id": 123,
"server_id": 123,
"type": "string",
"owner": "string",
"status": "string",
"location": "string",
"config": "string",
"full_location": "string",
"ip": "string",
"days_left": 30,
"due_date": "2024-12-31T23:59:59Z"
}
]
}

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

``` { "code": -1, "message": "presets: action required" }

```

presets/show¶

Возвращает детальную информацию о пресете по его ID, включая связанные теги и параметры конфигурации

HTTP-метод: POST|GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Действие модуля (значение: `show`)
token	❌	string	Токен авторизации

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

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

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

{
"result": "OK",
"action": "show",
"data": {
"id": 123,
"name": "Standard VPS Preset",
"active": 1,
"virtual": 0,
"monthly_ru": 500.0,
"monthly_com": 7.5,
"monthly_usd": 6.8,
"tags": [
{
"id": 1,
"name": "high-performance"
},
{
"id": 2,
"name": "ssd"
}
]
}
}

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

``` { "code": -404, "message": "Preset not found", "details": { "id": 123 } }

```