presets.php¶

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

Методы API¶

Метод	Действие	Описание
`groups`	получение групп	Возвращает список доступных групп пресетов
`info`	получение информации	Возвращает список доступных валют для отображения цен пресетов
`list`	получение списка пресетов	Возвращает список доступных пресетов с учетом локации и прав доступа пользователя
`search`	поиск серверов по пресету	Возвращает список подходящих серверов на основе имени пресета, области видимости (free/all) и локации
`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",
"action": "groups",
"data": [
{
"id": 1,
"name": "Standard Group"
}
]
}

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

``` { "code": -1, "message": "Ошибка получения групп" }

```

presets/info¶

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

HTTP-метод: GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `info`
token	❌	string	Токен авторизации
currencies	❌	string	Список валют через запятую (например: USD,EUR)

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

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

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

{
"result": "OK",
"action": "info",
"presets": []
}

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

``` { "code": -1, "message": "Action required" }

```

presets/list¶

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

HTTP-метод: GET

Параметры:

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

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

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

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

{
"result": "OK",
"action": "list",
"presets": [
{
"id": 1,
"name": "example",
"price": {
"EUR": 49.99,
"RUB": 5000
},
"available": 10,
"total": 100,
"server_type": "standard",
"tags": [
{
"id": 1,
"name": "high-performance"
}
]
}
]
}

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

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

```

presets/search¶

Возвращает список подходящих серверов на основе имени пресета, области видимости (free/all) и локации

HTTP-метод: POST|GET

Параметры:

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

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

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": 123,
"server_id": 123,
"type": "Component1.ref_tableName",
"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": "$module/search: invalid token, logout" }

```

presets/show¶

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

HTTP-метод: GET

Параметры:

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

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

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

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

{
"result": "OK",
"action": "show",
"presets": [
{
"id": 123,
"name": "High Performance",
"cpu": "4 Cores",
"ram": 16,
"hdd": 500,
"gpu": "NVIDIA RTX 3080",
"virtual": true,
"description": "Powerful preset for gaming",
"locations": [
"NL",
"DE"
],
"monthly_ru": 4500.0,
"monthly_com": 55.0,
"monthly_usd": 60.0,
"hourly_usd": 0.0382,
"hourly_com": 0.0382,
"hourly_ru": 31.25,
"regions": {
"NL": "10+"
},
"server_type": "Instant Server",
"tags": [
{
"id": 1,
"name": "gaming"
}
]
}
]
}

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

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

```