Получение списка архивов, в которые ведется запись

GET http://P-адрес:порт/префикс/archive/list/{VIDEOSOURCEID}

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

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

GET http://127.0.0.1:80/archive/list/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0

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

{
 "archives" : [
  {
   "default" : true,
   "name" : "hosts/SERVER1/MultimediaStorage.AliceBlue/MultimediaStorage"
  },
  {
   "default" : false,
   "name" : "hosts/SERVER1/MultimediaStorage.AntiqueWhite/MultimediaStorage"
  }
 ]
}


ПараметрОписание
default
  • true – архив по умолчанию;
  • false – не архив по умолчанию
name

Имя архива

Получение содержания архива

GET http://IP-адрес:порт/префикс/archive/contents/intervals/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} – получение содержания архива, начиная от момента времени BEGINTIME, заканчивая моментом времени ENDTIME.

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

В случае, если BEGINTIME не указан, подразумевается значение, соответствующее бесконечному будущему. Если при этом ENDTIME также не указан, подразумевается его значение, соответствующее бесконечному прошлому. Вместо BEGINTIME и ENDTIME могут быть использованы слова "past" или "future", означающие бесконечное прошлое и бесконечное будущее соответственно.

Порядок выдачи интервалов соответствует отношению между заданными BEGINTIME и ENDTIME (по возрастанию, если BEGINTIME<ENDTIME, и по убыванию, если ENDTIME<BEGINTIME). При этом начало и конец интервала всегда выдаются в естественном порядке, т.е. значение времени начала интервала будет меньше либо равно времени конца интервала).

Время задается в формате YYYYMMDDTHHMMSS в часовом поясе UTC+0. Также можно задать миллисекунды через точку. Пример: 20200512T105111.089.


ПараметрОбязательныйОписание
limitНетКоличество интервалов в ответе, по умолчанию 100
scaleНетМинимальное временнóе расстояние между двумя интервалами в секундах, при котором они будут выданы как два различных интервала (а не склеены в один), значение по умолчанию равно 0
archiveНетИмя архива, из которого необходимо получить интервалы. Если не задан, интервалы возвращаются из архива по умолчанию

Пример запроса получения содержания всех архивов:

GET http://127.0.0.1:80/archive/contents/intervals/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0/past/future

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

{
 "intervals": [
  {
   "begin": "20200512T105111.089000",
   "end": "20200521T121106.032000"
  },
  {
   "begin": "20200430T052909.842000",
   "end": "20200430T063733.242000"
  }
 ],
 "more": true
}

Пример запроса получения содержания определённого архива:

GET http://127.0.0.1:80/archive/contents/intervals/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0/past/future?archive=hosts/SERVER1/MultimediaStorage.AliceBlue/MultimediaStorage

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

{
 "intervals" : [
  {
   "begin" : "20210910T070448.179000",
   "end" : "20210910T071923.970000"
  }
 ],
 "more" : false
}


ПараметрОписание
intervals

Массив, содержащий интервалы

Время возвращается в формате UTC.

more
  • true – Сервер вернул не все интервалы из-за превышения лимита (параметр limit);
  • false – Сервер вернул все интервалы из заданного отрезка времени
<script type="text/javascript" src="https://asciinema.org/a/99428.js" id="asciicast-99428" async></script>