Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

GET http://IP-адрес:порт/префикс/archive/events/detectors/VIDEOSOURCEID/{ENDTIME}/BEGINTIME?limit=COUNT&offset=COUNT&join=COUNT&limit_to_archive=COUNT&archive=name - получение списка срабатываний детекторов.

В случае, если значение limit не указано, оно считается равным 100. 

offset - смещение результатов выдачи на заданное число. Например, если запрос с offset=0 вернул 100 результатов, то для получения следующих необходимо выполнить запрос с offset=100. Если на второй запрос было возвращено 250 результатов, то для получения следующих требуется задать в запросе offset=350 и т.д.

Поле timestamp не уникальное, поэтому, может понадобиться пропуск уже полученных ранее срабатываний детекторов от начала интервала поиска.

Если join=1, то в ответ будет выполняться склейка двухфазных событий и возвращаться параметр duration - длительность события.

Если join=0, то в ответе двухфазные события не будут склеиваться.

Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива).

archive - имя архива из запроса получения списка архивов (см. Получение содержания архивов).

Info

Параметры limit_to_archive и archive доступны, начиная с Axxon Next 4.4.1.9150.

Примеры ответа:

{BEGINTIME} - получение сработок со всех Серверов Axxon-домена.

Info
titleПримечание

Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов

GET http://IP-адрес:порт/префикс/archive/events/detectors/{HOSTNAME}/{ENDTIME}/{BEGINTIME} -  получение сработок с конкретного Сервера.

Tip

{HOSTNAME} - имя Сервера (см. Получение списка серверов).

GET http://IP-адрес:порт/префикс/archive/events/detectors/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} - получение сработок с конкретной видеокамеры.

Tip

{VIDEOSOURCEID} - трехкомпонентный идентификатор endpoint-а источника (см. Получение списка источников видео (камер)).  Например,  "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

?limit=COUNT&offset=COUNT&join=COUNT&limit_to_archive=COUNT&archive=name - получение списка срабатываний детекторов.

ПараметрОбязательныйОписание
limitНетЛимит сработок в ответе. Если не задан, по умолчанию 100.
offsetНетСмещение результатов выдачи на заданное число. Например, если запрос с offset=0 вернул 100 результатов, то для получения следующих необходимо выполнить запрос с offset=100. Если на второй запрос было возвращено 250 результатов, то для получения следующих требуется задать в запросе offset=350 и т.д.
typeНетПолучение сработок конкретного детектора. Список значений параметра type приведен ниже в таблице.
joinНет

Если join=1, то в ответ будет выполняться склейка двухфазных событий и возвращаться параметр duration - длительность события.

Если join=0, то в ответе двухфазные события не будут склеиваться.

limit_to_archiveНет

Доступен, начиная с Axxon Next 4.4.1.9150.

Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива).

archiveНет

Доступен, начиная с Axxon Next 4.4.1.9150.

Имя архива из запроса получения списка архивов (см. Получение содержания архивов).

Поле timestamp не уникальное, поэтому, может понадобиться пропуск уже полученных ранее срабатываний детекторов от начала интервала поиска.

Примеры запросов:

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 - получить сработки всех лучей c Server1. Максимальное количество по каждому лучу - 5.

http://127.0.0.1:80/archive/events/detectors/past/future?limit=1&type=Ray Получить текущее состояние всех лучей Axxon-домена.

Примеры ответа:

Expand

1) join=1

Code Block
{
    "events": [
        {
            "duration": "000000.467000",
            "id": "09b8729a-a6fc-4ffa-8a83-aebc5c19d171",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.20831976890563964",
Expand

1) join=1

Code Block
{
    "events": [
        {
            "duration": "000000.467000",
            "id": "09b8729a-a6fc-4ffa-8a83-aebc5c19d171",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.20831976890563964",
                    "index": "0",
                    "left": "0.57320795059204099",
                    "right": "0.6804207420349121",
                    "top": "0.09125151634216308"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112815.527000",
            "type": "moveInZone"
        },
        {
            "duration": "000004.154000",
            "id": "90c5d09e-c0bb-4c49-bf8b-22d3afffe8c1",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.72451157569885249",
                    "index": "0",
                    "left": "0.092941055297851571",
                    "right": "0.24284084320068361",
                    "top": "0.4965816402435303"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112814.426000",
            "type": "moveInZone"
        },
        {
            "duration": "000005.155000",
            "id": "dc953fad-bb08-4bae-bdce-62a09ab2dbd9",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.37916545867919921",
                    "index": "0",
                    "left": "0.10621988296508789",
                    "right": "0.2311831474304199",
                    "top": "0.11115360260009766"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112814.293000",
            "type": "moveInZone"
        },
        {
            "duration": "000003.170000",
            "id": "f00875f0-bad7-4e74-879c-0a564baa9d36",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.2848846626281738",
                    "index": "0",
                    "left": "0.11811468601226806",
                    "right": "0.18662774562835693",
                    "top": "0.11245393753051756"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112813.358000",
            "type": "moveInZone"
        }
    ],
    "more": true
}

2) join=0

Code Block
{
    "events": [
        {
            "alertState": "ended",
            "id": "cd3571bb-73c1-45cb-8965-a01e167836db",
            "multiPhaseSyncId": "6d72973d-7188-4fa7-9bf9-e3ba6013f2e3",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125142.417000",
            "type": "moveInZone"
        },
        {
            "alertState": "began",
            "id": "310ce582-5f0d-4c27-a1d5-b14ccc5a877d",
            "multiPhaseSyncId": "6d72973d-7188-4fa7-9bf9-e3ba6013f2e3",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.46943313598632813",
                    "index": "0",
                    "left": "0.14642228603363036",
                    "right": "0.23025640964508054",
                    "top": "0.027766456604003897"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125142.200000",
            "type": "moveInZone"
        },
        {
            "alertState": "began",
            "id": "aa193bbc-89e8-4204-8805-ac8c915b323c",
            "multiPhaseSyncId": "807248bf-4cee-431e-a29f-18ee0ed911ce",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.36835212707519532",
                    "index": "0",
                    "left": "0.072501201629638662",
                    "right": "0.19335731506347656",
                    "top": "0.03212909698486327"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125141.966000",
            "type": "moveInZone"
        },
        {
            "alertState": "ended",
            "id": "5b15234d-2a7f-415f-af57-2ac1ce5aa75a",
            "multiPhaseSyncId": "17fca913-f7a3-4f29-997f-d02a575d9fc4",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125136.978000",
            "type": "moveInZone"
        },
        {
            "alertState": "ended",
            "id": "48882f92-a809-424c-b7a7-55ac56b05061",
            "multiPhaseSyncId": "8bb9edbe-4391-4c26-8c7a-7faf620a62eb",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125136.661000",
            "type": "moveInZone"
        },
        {
            "alertState": "ended",
            "id": "6e98f979-c4f4-4c78-bbf4-6fc268219d79",
            "multiPhaseSyncId": "92534e2f-0f88-4698-a1a2-4e70d10cb00a",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125136.477000",
            "type": "moveInZone"
        },
        {
            "alertState": "ended",
            "id": "c9dff8bc-423b-414b-8dee-0a0b119a43df",
            "multiPhaseSyncId": "c8785151-f344-4c21-88de-6c339139afdf",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125135.843000",
            "type": "moveInZone"
        },
        {
            "alertState": "ended",
            "id": "db1f1147-ed50-46ff-84b7-8f06676d8f8e",
            "multiPhaseSyncId": "7eceb0b4-c04d-4e17-a405-3aff419fd94a",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125135.677000",
            "type": "moveInZone"
        },
        {
            "alertState": "began",
            "id": "f9ccceda-9e16-4832-9f1f-1270fd0be365",
            "multiPhaseSyncId": "17fca913-f7a3-4f29-997f-d02a575d9fc4",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.30296741485595702",
                    "index": "0",
                    "left": "0.14849423646926879",
                    "right": "0.21262614011764525",
                    "top": "0.092105445861816404"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125135.677000",
            "type": "moveInZone"
        },
        {
            "alertState": "began",
            "id": "87ca4e1e-4a8c-433a-8b67-6e73f65fa0e2",
            "multiPhaseSyncId": "7eceb0b4-c04d-4e17-a405-3aff419fd94a",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.22597263336181642",
                    "index": "0",
                    "left": "0.080717468261718744",
                    "right": "0.19577339172363281",
                    "top": "0.014194698333740235"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T125134.909000",
            "type": "moveInZone"
        }
    ],
    "more": true
}


...

Info
titleПримечание

Параметр multiPhaseSyncId будет в ответе только для двухфазных тревог с параметром alertState.

...

– как обычно, трехкомпонентным, например - "HOST/DeviceIpint.2/SourceEndpoint.video:0:0";

– именем хоста, для получения событий с него;

...

будет в ответе только для двухфазных тревог с параметром alertState.

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

Code Block
Code Block
       {
            "alertState": "happened",
            "extra": [
                {
                    "queueMaxalertState": "4happened",
                },"extra": [
                {
                    "queueMinqueueMax": "4"
                },
            ],
    {
        "id": "b17129b2-1588-794b-94f6-d078a226efb2",
            "originqueueMin": "hosts/A-KELEMETOV/AVDetector.4/EventSupplier",
               "rectangles": [], }
            "source": "hosts/A-KELEMETOV/DeviceIpint.2/SourceEndpoint.video:0:0"],
            "timestampid": "20181206T075621.621000b17129b2-1588-794b-94f6-d078a226efb2",
            "type": "QueueDetected"
        }
}

...

http://IP-адрес:порт/префикс/archive/events/detectors/HOST/DeviceIpint.2/SourceEndpoint.video:0:0/past/future?limit=10&offset=0 - получить сработки по указанной видеокамере, отсортированные по убыванию. Максимальное количество - 10.

http://IP-адрес:порт/префикс/archive/events/detectors/HOST/past/future?limit=5&offset=0 - получить сработки всех детекторов, созданных на машине HOST. Максимальное количество по каждому детектору - 5.

http://IP-адрес:порт/префикс/archive/events/detectors/HOST/past/future?limit=5&offset=0&type=Ray - получить сработки всех лучей, созданных на машине HOST. Максимальное количество по каждому лучу - 5.

...

"origin": "hosts/Server1/AVDetector.4/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.2/SourceEndpoint.video:0:0",
            "timestamp": "20181206T075621.621000",
            "type": "QueueDetected"
        }
}

Возможные значения параметра type:

...