Перейти в хранилище документации
Обратиться в техническую поддержку
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 | Нет | Если join=1, то в ответ будет выполняться склейка двухфазных событий и возвращаться параметр duration – длительность события. Если join=0, то в ответе двухфазные события не будут склеиваться. |
| limit_to_archive | Нет | Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива). |
| archive | Нет | Имя архива из запроса получения списка архивов (см. Получение содержания архивов). |
| detector | Нет | Получение сработок конкретного детектора. Список значений параметра detector приведен ниже в таблице. |
Примеры запросов:
- 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/A-ZHUKOV/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 – получить текущее состояние всех лучей домена.
Примеры ответа:
Внимание!
По умолчанию таймаут запроса – 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"
}
}
Возможные значения параметра 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 |
Возможные значения параметра detector:
| detector | Детектор |
| SceneDescription | Трекер объектов или Нейротрекер |
| CrossOneLine | Пересечение линии |
| moveInZone | Движение в области |
| StopInZone | Остановка в области |
| ComeInZone | Вход в область |
| OutOfZone | Выход из области |
| LongInZone | Длительное пребывание в области |
| lostObject | Множество объектов |
| LprDetector | Детектор распознавания номеров |
| TvaFaceDetector | Детектор лиц |
| PeopleCounter | Подсчет посетителей |
| QueueDetector | Детектор очереди |
| FireDetector | Детектор огня |
| SmokeDetector | Детектор дыма |
| NeuroCounter | Нейросчетчик |
| SceneChange | Изменение положения |
| QualityDegradation | Деградация качества |
| QualityDegradation_v2 | Детектор зашумления изображения |
| BlurredDegradation | Детектор размытого изображения |
| CompressedDegradation | Детектор артефактов сжатия |
| MotionDetection | Детектор движения |
| NullAudioDetection | Отсутствие звука |
| SignalAudioDetection | Детектор сигнала |
| NoiseAudioDetection | Детектор шума |
| PoseDetector | Детектор позы |
| RecumbentDetector | Детектор лежащего человека |
| SitDownDetector | Детектор сидящего человека |
| HandsUpDetector | Детектор поднятых рук |
| ActiveShooterDetector | Детектор стрелка |
| WaterLevelDetector | Детектор уровня воды |
| HandRailDetector | Детектор держания за поручень |
| PeopleCountDetectorBySkeleton | Счетчик людей |
| PeopleDistanceDetector | Детектор близко стоящих людей |
| PoseMaskingDetector | Маскирование людей |
Внимание!
- Не гарантируется регистрозависимость типов сработок детекторов. Например, значения 'ComeInZone', 'comeInZone', 'COMEINZOne' следует рассматривать как одинаковые.
- Если было получено значение, не входящее в указанный список, значит это сработка встроенного детектора.
Overview
Content Tools