Клиент может подключиться к бэкенд-серверу для получения данных и управления мониторингом двумя способами:
- при помощи Websocket API
- при помощи REST API
Взаимодействие при помощи Websocket API
Для получения информации о потоках на WCS в реальном времени, а также для управления мониторингом, используется Websocket API на базе протокола STOMP
Подключение к бэкенд-серверу по STOMP через Websocket
Для подключения к бэкенд-серверу необходимо:
1. Установить Secure Websocket соединение по адресу https://hostname:8090/ws, где hostname – имя бэкенд-сервера
2. Установить соединение по протоколу STOMP, отправив сообщение
CONNECT accept-version:1.2 host:hostname ^@
3. Подписаться на очередь /alarms для получения тревог, отправив сообщение
SUBSCRIBE id:sub-0 destination:/alarm ^@
4. Подписаться на очередь для получения ответов на отправленные запросы /user/service, отправив сообщение
SUBSCRIBE id:sub-1 destination:/user/service ^@
Взаимодействие при помощи REST API
Для получения информации о потоках на WCS, а также для управления мониторингом, может быть использовано REST API
REST-запрос должен быть HTTPS POST запросом в таком виде:
- HTTPS: https://wcsoam.flashphoner.com:8090/api/stream/history
Здесь:
- wcsoam.flashphoner.com - адрес бэкенд-сервера
- 8090 - HTTPS порт
- /api/stream/history - используемый REST-метод
Настройка подключения
Настройка порта
HTTPS порт для обработки REST запросов и WSS подключений настраивается при помощи параметра
server.port = 8090
Настройка таймаута Websocket соединения
Таймаут соединения настраивается при помощи параметра в файле wcsoam.properties
stomp_max_timeout=1000