Программная реализация
Программно HTTP API предоставляется модулем web2 − Веб-сервер 2.0 (см. Настройка Сервера для подключения Клиентов с помощью модуля Веб-сервер 2.0).
Возможности
HTTP API позволяет использовать следующие функции:
- Получать сведения об интерактивных картах: список карт, имя карты, список слоев карты, параметры слоя, фоновый рисунок слоя, информация о списке точек и отдельной точке на слое (см. Карта).
- Получать сведения о классах объектов, созданных на Сервере, список состояний для класса объектов и информацию о состоянии, а также иконки для определенного состояния (см. Классы объектов).
- Получать список объектов, созданных на сервере, информацию об отдельном объекте, состояния объекта, список доступных действий с объектом (см. Объекты).
- Получать события с Сервера как отдельно, так и блоками (см. Получение событий).
- Отсылать команды на Сервер (см. Отсылка команд на сервер).
- Запускать выполнение макрокоманд (см. Макрокоманды).
- Работать с видео: получить кадры, запрашивать конфигурацию, получать живое видео и архив, управлять записью, ставить и снимать камеры с охраны, управлять телеметрией (см. Видео).
- Получать живой и архивный звук (см. Звук).
- Получать список пользователей (см. Пользователи).
- Отправлять события и реакции в ядро ПК Интеллект (см. Отправка реакций и событий в ПК Интеллект по HTTP-запросу).
- Обращаться к API Face-Интеллект и API Авто-Интеллект (см. Обращение к API вертикальных решений через HTTP API ПК Интеллект).
- Настраивать интеграции с Техносерв и ЕЦХД (см. Настройка интеграции с Техносерв и Команды, используемые для интеграции ЕЦХД).
Особенности и ограничения
- В примерах, приводимых в данном разделе, используются следующие обозначения:
- Port – порт. По умолчанию порт модуля Веб-сервер 2.0 – 8085. Указывать порт при отправке команд HTTP API обязательно.
- /web2 – веб-контекст, в котором работает модуль web2. Это контекст веб-приложения.
Далее описание будет опускаться там, где действие запроса понятно из контекста.
...
- URL, id объектов и расширения файлов чувствительны к регистру
...
- .
- Дата и время указываются в формате RFC3339, подробнее см. http://www.ietf.org/rfc/rfc3339.txt.
- Должно быть отключено сжатие сообщений от ядер, то есть ключ реестра MsgCompressOn=0 (см. Справочник ключей для Интеллекта базового).
Авторизация
Для выполнения запросов необходима авторизация. Поддерживаются 2 типа авторизации: Basic и Bearer.
...