⌂ > ⎘ Открытый REST API

GET /command?type=setprofile : Установка профиля экрана на клиенте🔗

Доступно во всех типах лицензий.

Важно

Во всех примерах указан локальный хост (localhost). При отправке реальных запросов замените его на адрес и порт сервера, на который отправляете запрос.

Примечание

HTTP-интерфейс Macroscop позволяет не только получать сведения о системе, но и управлять некоторыми её элементами, выполняя описанные ниже CGI-запросы.

Такие запросы, за одним исключением, имеют следующий формат:

{Протокол}://{Сервер}:{Порт}/command?type={Тип}&login={Логин}&password={Пароль}&{Параметр}={Значение параметра}

Для передачи на подключённый к серверу Macroscop Клиент команды о смене профиля экрана используется тип запроса setprofile.

Примечание

С помощью данного запроса можно устанавливать только серверные профили экрана. Профили (виды), созданные непосредственно на клиенте, запросом не поддерживаются.

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

GET http://localhost:8080/command?type=setprofile&login=root&password=&clientip=192.168.1.2&monitor=0&profileid=13851f3d-c7d3-4ec6-b0ff-2d66873bf118

Дополнительные параметры запроса🔗

Параметр

Значение по умолчанию

Описание

clientip

—

IP адрес устройства, на котором запущено клиентское приложение Macroscop. Обязательный параметр

monitor

—

Номер монитора в действующей конфигурации клиентского приложения. Отсчёт начинается с 0. Обязательный параметр

profileid

—

Идентификатор профиля экрана для установки. Список доступных профилей может быть получен с помощью запроса Получение списка серверных профилей экрана

Примечание

Значение clientip должно содержать фактический адрес клиента Macroscop. Использование localhost (127.0.0.1) вызовет ошибку даже при обращении к клиенту, установленному непосредственно на сервере.