Versions Compared

Key

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

...

  • GET http://IP-адрес:порт/префикс/archive/events/detectors/{ENDTIME}/{BEGINTIME} – получение событий от детекторов со всех серверов домена.
    Note
    titleВнимание!
    • Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов.
    • Если в запросе ENDTIME < BEGINTIME, то события в ответе будут отсортированы по возрастанию времени. 
    • Если 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".

Note
titleВнимание!

Для корректной работы параметров detector, archive и limit_to_archive необходимо указывать {VIDEOSOURCEID} в адресе запроса.

ПараметрОбязательныйОписание
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 будет указано в параметре name, например:

  • "name" : "hosts/SERVER/AVDetector.1/EventSupplier"
Note
titleВнимание!

Для корректной работы параметров 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 – получить текущее состояние всех лучей домена.

...