Перейти к основному содержимому
Версия: 1.18.1

Отправка событий по веб-сокетам и вебхукам

Эндпоинты

В OMNI Platform реализована возможность отправлять события во внешние сервисы по двум типам эндпоинтов: веб-сокету или вебхуку.

Веб-сокеты

Создать эндпоинт типа «веб-сокет»

Нажмите на кнопку + Создать в правом верхнем углу страницы эндпоинтов. В открывшейся вкладке выберите тип эндпоинта (Веб-сокет), укажите название эндпоинта и нажмите Создать.

Подробную информацию по каждому веб-сокету можно просмотреть в его карточке. Чтобы открыть карточку, нажмите на строку веб-сокета на странице эндпоинтов.

примечание

В верхнем левом углу карточки находится кнопка с сокращенным идентификатором (endpoint_id). При наведении на кнопку отобразится полная версия идентификатора, а при нажатии на кнопку идентификатор будет скопирован в буфер обмена.

Настроить отправку событий по веб-сокету

Ниже показано подключение по веб-сокету на примере HTTP-клиента Postman:

  1. Скачайте и установите Postman.

  2. В интерфейсе клиента выберите file -> new -> WebSocket.

  3. В открывшейся вкладке укажите request URL ws://$DOMAIN/event-service/ws?endpoint_id=<endpoint_id> для передачи событий по веб-сокету.

    ВНИМАНИЕ!

    Для подключения по веб-сокету используется endpoint_id, который указан в дашборде на странице Эндпоинты. Также запросить endpoint_id можно через API (См.пункт Эндпоинты событий раздела Справочник по API).

    Для фильтрации отправляемых по веб-сокету событий необходимо привязать эндпоинт к фильтру событий, в противном случае будут приходить все события.

  4. Соединение установлено, события отправляются на сервер.

    примечание

    Поскольку данные платформы и агента синхронизируются в среднем один раз в минуту, может произойти следующая ситуация:

    Если в течение в среднем одной минуты после удаления профиля из базы человек, которому принадлежал этот профиль, попадает в поле зрения камеры, OMNI-агент формирует событие идентификации и передает его в платформу. Профиля на платформе уже не существует, поэтому платформа не сможет передать такое событие по веб-сокету. Такие «потерянные» события можно будет вывести только через GraphQL API платформы.

Пример события, переданного по веб-сокету:

{"type": "identification", 
"activity_id": "69410e11-d3f6-449c-927f-cea210f0e326",
"camera": {"id": "72aa3a70-0fc1-46f1-8a8e-eb50cd4f13a3", "type": "IP", "title": "rtsp://192.168.122.150/stream", "stream": "rtsp://192.168.122.150/stream", "real_name": null, "agent_id": "a593c1be-d13e-4244-8179-1df0a6b725f7"},
"candidates": [{
"profile": {
"id": "d96fb010-8da5-49a6-b571-b48cb241a923",
"age": 30,
"gender": "MALE",
"avatar_id": "e5a1f9b6-9e10-4ac2-8723-bbae0b9d9200",
"main_sample_id": "e5a1f9b6-9e10-4ac2-8723-bbae0b9d9200",
"sample_link": "http://op-v1-18-0-rc1.platform.kuber2.3divi.ru/get-image/e5a1f9b6-9e10-4ac2-8723-bbae0b9d9200"},
"profile_groups": [{"id": "82e7d0c3-6e69-425b-ab79-faa19c2d9fe7", "color": "orange.400"}],
"confidence": 0.9359086751937866}],
"event": {
"id": "b4c32a55-685e-4055-9716-aeda8c892c84",
"detection_date": "2024-05-29 10:48:27.364000+00:00",
"image": "ddf08b27-1bc6-409f-9b27-f099268453cb",
"original_image": "3841d16d-34c5-48dd-9135-f39126477078",
"image_link": "http://op-v1-18-0-rc1.platform.kuber2.3divi.ru/event-service/get-image/ddf08b27-1bc6-409f-9b27-f099268453cb", "original_image_link": "http://op-v1-18-0-rc1.platform.kuber2.3divi.ru/event-service/get-image/3841d16d-34c5-48dd-9135-f39126477078"}}

Вебхуки

Создать эндпоинт типа «вебхук»

Нажмите на кнопку + Создать в правом верхнем углу страницы эндпоинтов. В открывшейся вкладке выберите тип эндпоинта (Вебхук), укажите название эндпоинта и нажмите Создать.

Подробную информацию по каждому вебхуку можно просмотреть в его карточке. Чтобы открыть карточку, нажмите на строку вебхука на странице эндпоинтов.

примечание

В верхнем левом углу карточки находится кнопка с сокращенным идентификатором (endpoint_id). При наведении на кнопку отобразится полная версия идентификатора, а при нажатии на кнопку идентификатор будет скопирован в буфер обмена.

Пример события, переданного через вебхук:

{
"type": "identification",
"activity_id": "acf8120f-5047-4c15-80f5-4f5b56d250c2",
"camera": {
"id": "72aa3a70-0fc1-46f1-8a8e-eb50cd4f13a3",
"type": "IP",
"title": "rtsp://192.168.122.150/stream",
"stream": "rtsp://192.168.122.150/stream",
"real_name": null,
"agent_id": "a593c1be-d13e-4244-8179-1df0a6b725f7"
},
"candidates": [
{
"profile": {
"id": "d96fb010-8da5-49a6-b571-b48cb241a923",
"age": 30,
"gender": "MALE",
"avatar_id": "e5a1f9b6-9e10-4ac2-8723-bbae0b9d9200",
"main_sample_id": "e5a1f9b6-9e10-4ac2-8723-bbae0b9d9200",
"sample_link": "http://op-v1-18-0-rc1.platform.kuber2.3divi.ru/get-image/e5a1f9b6-9e10-4ac2-8723-bbae0b9d9200"
},
"profile_groups": [
{
"id": "82e7d0c3-6e69-425b-ab79-faa19c2d9fe7",
"color": "orange.400"
}
],
"confidence": 0.9436722993850708
}
],
"event": {
"id": "348e726d-d78d-4a7f-b5b4-e6b3cf956b78",
"detection_date": "2024-05-29 09:44:15.727000+00:00",
"image": "f847fd16-8ca3-408f-9927-aac80f7e2f89",
"original_image": "5e46d1d7-ca5b-4804-9c7e-6022f5a561b7",
"image_link": "http://op-v1-18-0-rc1.platform.kuber2.3divi.ru/event-service/get-image/f847fd16-8ca3-408f-9927-aac80f7e2f89",
"original_image_link": "http://op-v1-18-0-rc1.platform.kuber2.3divi.ru/event-service/get-image/5e46d1d7-ca5b-4804-9c7e-6022f5a561b7"
}
}

Фильтрация и сортировка

Параметры фильтрации
  • По идентификатору эндпоинта
  • По типу эндпоинта
Параметры сортировки
  • По дате создания

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

Фильтры событий

Перед отправкой на прикрепленные эндпоинты (по веб-сокетам или вебхукам) события можно отфильтровать по следующим параметрам:

  • по камерам и OMNI-агентам, с которых приходят события;
  • по спискам наблюдения, в которые добавлен человек с события;
  • по типам событий.

Создать фильтр событий

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

Просмотреть данные созданного фильтра, изменить параметры фильтрации или удалить фильтр можно в его карточке. Чтобы открыть карточку, нажмите на строку фильтра на странице фильтров событий.

Фильтрация и сортировка

Параметры фильтрации
  • По идентификаторам фильтров событий
Параметры сортировки
  • По дате создания
  • По дате изменения

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