Перейти в хранилище документации
Обратиться в техническую поддержку
На странице:
Общие сведения
- GET http://IP-адрес:порт/префикс/archive/events/detectors/{ENDTIME}/{BEGINTIME} – получение событий от детекторов со всех серверов домена.
Внимание!
- Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов.
- Если в запросе ENDTIME < BEGINTIME, то события в ответе будут отсортированы по возрастанию времени.
- Если ENDTIME > BEGINTIME, то сортировка будет по убыванию.
- GET http://IP-адрес:порт/префикс/archive/events/detectors/{HOSTNAME}/{ENDTIME}/{BEGINTIME} – получение событий от детекторов с конкретного сервера.
{HOSTNAME} – имя сервера (см. Получение списка Серверов).
- GET http://IP-адрес:порт/префикс/archive/events/detectors/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} – получение событий от детекторов с конкретной камеры.
{VIDEOSOURCEID} – трехкомпонентный идентификатор endpoint-а источника (см. Получение списка камер и информации о них). Например, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".
| Параметр | Обязательный | Описание |
|---|---|---|
| limit | Нет | Лимит событий от детекторов в ответе. Если не задан, по умолчанию 100 |
| offset | Нет | Смещение результатов выдачи на заданное число. Например, если запрос с offset=0 вернул 100 результатов, то для получения следующих необходимо выполнить запрос с offset=100. Если на второй запрос было возвращено 250 результатов, то для получения следующих требуется задать в запросе offset=350 и т.д. |
| type | Нет | Получение событий от детектора конкретного типа. Список возможных значений параметра type приведен ниже в таблице. Если необходимо получить события от нескольких типов, их необходимо перечислить через запятую |
| join | Нет |
|
| limit_to_archive | Нет | Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива) |
| archive | Нет | Имя архива из запроса получения списка архивов (см. Получение содержания архивов) |
| detector | Нет | Получение событий от конкретного детектора по определенной камерой. Для получения конкретного значения можно выполнить запрос Получение списка детекторов камеры. В результате после выполнения запроса значение для параметра detector будет указано в параметре name, например:
|
Внимание!
Для корректной работы параметров detector, archive и limit_to_archive необходимо указывать {VIDEOSOURCEID} в адресе запроса.
Примеры запросов
- http://127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.2/SourceEndpoint.video:0:0/past/future?limit=10&offset=0 – получить события по указанной камере, отсортированные по убыванию. Максимальное количество – 10.
- http://127.0.0.1:80/archive/events/detectors/Server1/past/future?limit=5&offset=0 – получить события от всех детекторов с Server1. Максимальное количество по каждому детектору – 5.
- http://127.0.0.1:80/archive/events/detectors/Server1/past/future?limit=5&offset=0&type=Ray – получить события всех лучей с Server1. Максимальное количество по каждому лучу – 5.
- http://127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/future/past?limit=100&detector=hosts/Server1/AVDetector.1/EventSupplier – получить события от конкретного детектора с Server1.
- http://root:root@127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20230323T112000.000/20230430T210000.000?limit=100&offset=0&type=listed_face_detected,MotionDetected – получить события от нескольких детекторов с Server1. Детекторы необходимо перечислить через запятую.
- http://127.0.0.1:80/archive/events/detectors/past/future?limit=1&type=Ray – получить текущее состояние всех лучей домена.
Внимание!
Рекомендуется использовать параметр past/future только в первом запросе. Затем следует получить timestamp самой последней записи и использовать его для запрашивания последующих записей. Использование параметра past/future вместе с параметрами limit и offset в последующих запросах может привести к возникновению дубликатов записей.
Примеры ответов
Внимание!
По умолчанию таймаут запроса – 10 секунд.
Если сервер за 10 секунд не успеет вернуть все события (количество задается параметром limit), ответ будет следующим:
{
"events": [],
"more": false
}
В этом случае необходимо повторить запрос и уменьшить значение параметра limit.
Примечание
- Параметр multiPhaseSyncId будет в ответе только для двухфазных тревог с параметром alertState.
- Поле timestamp не уникальное, поэтому может понадобиться пропуск уже полученных ранее событий от детекторов от начала интервала поиска.
При запросе событий от детектора очереди в ответе будет дополнительный параметр extra, который будет содержать оценку длины очереди, выраженной минимальным и максимальным значением.
{
"alertState": "happened",
"extra": [
{
"queueMax": "4"
},
{
"queueMin": "4"
}
],
"id": "b17129b2-1588-794b-94f6-d078a226efb2",
"origin": "hosts/Server1/AVDetector.4/EventSupplier",
"rectangles": [],
"source": "hosts/Server1/DeviceIpint.2/SourceEndpoint.video:0:0",
"timestamp": "20181206T075621.621000",
"type": "QueueDetected"
}
}
При запросе событий от детекторов распознавания номеров в ответе будет дополнительный параметр plate, который будет содержать распознанный номер транспортного средства в формате Unicode.
{
"alertState" : "happened",
"id" : "f1f334a3-3fb3-4770-80bf-c6519240b5cf",
"origin" : "hosts/Server1/AVDetector.1/EventSupplier",
"plate" : "\u0412427\u0412\u041c99",
"rectangles" :
[
{
"bottom" : 0.70833333333333337,
"index" : 0,
"left" : 0.4597222222222222,
"right" : 0.67222222222222228,
"top" : 0.64409722222222221
}
],
"source" : "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
"timestamp" : "20230725T140945.208000",
"type" : "plateRecognized"
}
Возможные значения параметра type
Внимание!
Возможные значения параметра type зависят от версии продукта и установленных детекторов. Для получения актуальных значений можно выполнить запрос получения списка детекторов по конкретной камере (см. Получение списка детекторов камеры).
| Детектор | type |
| Трекер объектов или Нейротрекер | - |
| Пересечение линии | oneLine |
| Движение в области | moveInZone |
| Остановка в области | stopInZone |
| Вход в область | comeInZone |
| Выход из области | outOfZone |
| Длительное пребывание в области | longInZone |
| Множество объектов | lostObject |
| Детектор распознавания номеров | plateRecognized |
| Детектор распознавания номеров (распознавание номера из списка) | listed_lpr_detected |
| Детектор лиц | faceAppeared |
| Детектор лиц (распознавание лица из списка) | listed_face_detected |
| Подсчет посетителей | PeopleIn, PeopleOut |
| Детектор очереди | QueueDetected |
| Детектор огня | FireDetected |
| Детектор дыма | SmokeDetected |
| Нейросчетчик | lotsObjects |
| Изменение положения | SceneChangeDetected |
| Деградация качества | CameraBlindDetected |
| Детектор зашумления изображения | ImageDegradation |
| Детектор размытого изображения | BlurredDegradation |
| Детектор артефактов сжатия | CompressedDegradation |
| Детектор движения | MotionDetected |
| Отсутствие звука | NullAudio |
| Детектор сигнала | SignalAudio |
| Детектор шума | NoiseAudio |
| Детектор позы | - |
| Детектор лежащего человека | recumbent |
| Детектор сидящего человека | sitDown |
| Детектор поднятых рук | handsUp |
| Детектор стрелка | activeShooter |
| Детектор уровня воды | LevelOut |
| Детектор держания за поручень | handRail |
| Счетчик людей | lotsObjects |
| Детектор близко стоящих людей | peopleDistance |
| Маскирование людей | enabledMaskEvents |
Внимание!
- Не гарантируется регистрозависимость типов событий от детекторов. Например, значения ComeInZone, comeInZone, COMEINZOne следует рассматривать как одинаковые.
- Если было получено значение, не входящее в указанный список, значит это событие от встроенного детектора.
Overview
Content Tools