software.php¶

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

Методы API¶

Метод	Действие	Описание
`list`	получение списка программного обеспечения	Возвращает список программного обеспечения, подходящего для конкретного сервера (id) или пресета (instance_id), с учетом лицензий, характеристик оборудования и промо-акций.

software/list¶

Возвращает список программного обеспечения, подходящего для конкретного сервера (id) или пресета (instance_id), с учетом лицензий, характеристик оборудования и промо-акций.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
token	✅	string	Токен авторизации для доступа к API
id	❌	int	ID сервера для подбора совместимого ПО
instance_id	❌	int	ID пресета для подбора совместимого ПО
bill_period	❌	string	Период биллинга (monthly, hourly)
user_location	❌	string	Локация пользователя (например, COM, RU)

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

curl -s "https://invapi.hostkey.ru/software" -X POST \
--data "action=list" \
--data "token=HOSTKEY_TOKEN" \
--data "id=12345" \
--data "bill_period=monthly" \
--data "user_location=RU"

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

{
"result": "OK",
"action": "list",
"software": [
  {
    "id": 101,
    "name": "Windows Server 2022",
    "active": 1,
    "price": 45.0,
    "tags": [
      {
        "tag": "os",
        "value": "windows"
      },
      {
        "tag": "license",
        "value": "commercial"
      }
    ],
    "RUR_rate": 92.5
  },
  {
    "id": 102,
    "name": "Ubuntu 22.04 LTS",
    "active": 1,
    "price": 0.0,
    "tags": [
      {
        "tag": "os",
        "value": "linux"
      }
    ],
    "RUR_rate": 92.5
  }
],
"debug": [],
"debug_licensed_soft": {}
}

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

{
"code": -1,
"message": "soft/list: no software found"
}