Versions Compared

Key

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

...

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

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


Note
titleВнимание!

Если в запросе ENDTIME < BEGINTIME, то события в ответе будут отсортированы по возрастанию времени. 

Если ENDTIME > BEGINTIME, то сортировка будет по убыванию.

...

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

...

Tip

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


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

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

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

archiveНет

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

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

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

GET http://127.0.0.1:80/archive/events/alerts/Server1/past/future?limit=50&offset=0

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

Code Block
{
  "events": [
    {
      "type": "alert",
      "id": "2bb7f765-eb57-604d-a38c-d1d26d22e4d9",
      "raisedAt": "20181219T151437.312808",
      "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
      "reasons": [
        "ruleAlert",
        "videoDetector"
      ],
      "initiator": "faceAppeared",
      "reaction": {
        "user": "",
        "reactedAt": "20181219T151937.342036",
        "severity": "unclassified"
      },
      "detectorName": "1.Детектор лиц",
      "rectangles": [
        {
          "index": "47",
          "left": "0,85343749999999996",
          "top": "0,37958333333333333",
          "right": "1",
          "bottom": "0,58083333333333331"
        }
      ]
    },
    {
      "type": "alert",
      "id": "03c0d49f-5475-684e-a622-2aaeac303508",
      "raisedAt": "20181219T151005.933417",
      "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
      "reasons": [
        "ruleAlert",
        "videoDetector"
      ],
      "initiator": "faceAppeared",
      "reaction": {
        "user": "root",
        "reactedAt": "20181219T151013.109256",
        "severity": "alarm"
      },
      "detectorName": "1.Детектор лиц",
      "rectangles": [
        {
          "index": "9",
          "left": "0,83406249999999993",
          "top": "0,36416666666666664",
          "right": "1",
          "bottom": "0,58583333333333332"
        }
      ]
    },
    {
      "type": "alert",
      "id": "6d396f93-4acf-c54b-a26e-c1ab178bdb06",
      "raisedAt": "20181219T150911.101417",
      "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
      "reasons": [
        "userAlert"
      ],
      "initiator": "root",
      "reaction": {
        "user": "root",
        "reactedAt": "20181219T150916.264631",
        "severity": "alarm"
      },
      "detectorName": "",
      "rectangles": []
    }
  ],
  "more": false
}


ПараметрОписание
raisedAtПоле raisedAt не уникальное, поэтому может понадобиться пропуск уже полученных ранее тревог от начала интервала поиска.
reasonsВозможные значения в массиве reasons: armed, disarmed, userAlert, ruleAlert, videoDetector, audioDetector, ray.
severityВозможные значения поля severity: unclassified, false, notice, warning, alarm.
initiator:

Возможные значения поля initiator:

  1. Имя пользователя, инициировавшего тревогу.
  2. Id макрокоманды (см. Макрокоманды), если тревога инициирована макрокомандой, которая была запущена НЕ детектором. При этом следует иметь в виду, что данная макрокоманда может быть уже удалена из конфигурации.
  3. Тип детектора, который вызвал сработку макрокоманды, которая инициировала тревогу (см. Получение списка срабатываний детекторов).