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"
}