Информация об установленном программном обеспечении¶

Настройки команды

Список приложений собирается только при включенной в настройках команды опции Разрешить получение списка программного обеспечения с устройств. Подробнее см. в руководстве Настройки команды.

Список установленного ПО¶

Вы можете получить список установленных приложений на устройствах из раздела Постоянный доступ с помощью метода inventory/program/list.

Запрос:

HTTPcURL

GET /v1/inventory/program/list
  ?agent_id=<number>
  &group_id=<number>
  &type=<string>
  &date_from=<number>
  &date_to=<number>
  &version_from=<string>
  &version_to=<string>
  &name=<string>
  &publisher=<string>
  &search=<string>
  &offset=<number>
  &limit=<number>
Host: https://api.pro32connect.ru
X-Api-Key: YOUR_API_KEY

curl -G "https://api.pro32connect.ru/v1/inventory/program/list" \
  --data-urlencode "agent_id=<number>" \
  --data-urlencode "group_id=<number>" \
  --data-urlencode "type=<string>" \
  --data-urlencode "date_from=<number>" \
  --data-urlencode "date_to=<number>" \
  --data-urlencode "version_from=<string>" \
  --data-urlencode "version_to=<string>" \
  --data-urlencode "name=<string>" \
  --data-urlencode "publisher=<string>" \
  --data-urlencode "search=<string>" \
  --data-urlencode "offset=<number>" \
  --data-urlencode "limit=<number>" \
  -H "X-Api-Key: YOUR_API_KEY" \

Параметр	Тип	Значение
`agent_id`	`number`	Фильтр по устройству. Внутренний идентификатор устройства в системе
`group_id`	`number`	Фильтр по группе. Внутренний идентификатор группы в системе
`type`	`string`	Фильтр по типу установленного приложения. Возможные значения: `msi` — приложение, установленное через Windows Installer (.msi) `registry` — приложение, обнаруженное только через запись в реестре Windows `dpkg` — пакет, установленный через систему пакетов Debian (.deb) `rpm` — пакет, установленный через менеджер пакетов RPM (.rpm)
`date_from`	`number`	Фильтр по дате установки приложения. Начало периода. Значение в формате `unixtime`
`date_to`	`number`	Фильтр по дате установки приложения. Конец периода. Значение в формате `unixtime`
`version_from`	`string`	Фильтр по версии приложения. Минимальная версия. Формат Semantic Versioning (SemVer)
`version_to`	`string`	Фильтр по версии приложения. Максимальная версия. Формат Semantic Versioning (SemVer)
`name`	`string`	Фильтр по названию приложения. Используется точное совпадение
`publisher`	`string`	Фильтр по издателю приложения. Используется точное совпадение
`search`	`string`	Поиск по названию и издателю приложения. Используется регистронезависимый поиск по подстроке
`offset`	`number`	Смещение первого элемента в списке
`limit`	`number`	Количество элементов в списке. Значение по умолчанию: `20`; максимальное значение: `100`

Ответ:

Пример ответа

Данные ответа

{
    "filter": {
        "type": "msi"
    },
    "data":[ {
        "agent_ids": [1001, 1002],
        "name": "WireGuard",
        "publisher": "WireGuard LLC",
        "version": "0.5.3"
    },{
        "agent_ids": [1003],
        "name": "Node.js",
        "publisher": "Node.js Foundation",
        "version": "8.11.4"
    }, ... ],
    "total": 1024,
    "offset": 0,
    "limit": 20,
}

Название	Тип	Описание
`data`	`object`	Список установленных приложений
`data.[].name`	`string`	Название приложения
`data.[].publisher`	`string`	Издатель приложения
`data.[].version`	`string`	Минимальная версия приложения среди найденных устройств
`data.[].agent_ids`	`array`	Список внутренних идентификаторов устройств, на которых установлено приложение
`filter`	`object`	Применённый фильтр. Дублирует параметры запроса
`filter.group_id`	`number`	Внутренний идентификатор группы
`filter.type`	`string`	Тип установленного приложения
`filter.date_from`	`number`	Начало диапазона даты установки
`filter.date_to`	`number`	Конец диапазона даты установки
`filter.version_from`	`string`	Минимальная версия приложения
`filter.version_to`	`string`	Максимальная версия приложения
`filter.name`	`string`	Название приложения
`filter.publisher`	`string`	Издатель приложения
`filter.search`	`string`	Поиск по названию и издателю приложения
`total`	`number`	Общее количество записей в базе данных
`offset`	`number`	Индекс первой записи в возвращаемом списке (нумерация начинается с `0`)
`limit`	`number`	Максимальное количество записей, возвращаемых в списке