Веб-сокеты
В OMNI Platform реализована возможность отправлять события, приходящие от OMNI-агента, на сторонний сервис по веб-сокетам. Ниже показано подключение по веб-сокету на примере HTTP-клиента Postman:
- Скачайте и установите Postman.
- В интерфейсе клиента выберите file -> new -> WebSocket.
- В открывшейся вкладке укажите request URL:
ws://$DOMAIN/event-service/<event_type>/ws?endpoint_id=<endpoint_id>&scope_id=<workspace_id|agent_id|camera_id|profile_group_id>— для передачи событий по веб-сокету.
Для получения событий укажите тип событий, которые будут отправляться по веб-сокету. Всего доступно пять типов событий: non_identification, identification, har, roi, crossing.
Для подключения по веб-сокету используется endpoint_id, который указан в дашборде на странице Веб-сокеты. Также запросить endpoint_id можно через API (См.пункт Эндпоинты веб-сокета раздела Справочник по API).
Для фильтрации отправляемых по веб-сокету событий укажите значение scope_id. Доступны следующие значения фильтрации: идентификатор воркспейса, идентификатор агента, идентификатор камеры или идентификатор списка наблюдения.
- Соединение установлено, события отправляются на сервер.
Поскольку данные платформы и агента синхронизируются в среднем один раз в минуту, может произойти следующая ситуация:
Если в течение в среднем одной минуты после удаления профиля из базы человек, которому принадлежал этот профиль, попадает в поле зрения камеры, OMNI-агент формирует событие идентификации и передает его в платформу. Профиля на платформе уже не существует, поэтому платформа не сможет передать такое событие по веб-сокету. Такие «потерянные» события можно будет вывести только через GraphQL API платформы.