# Сервис видеозаписи Данная модель описывает REST-API интерфейс сервиса видеозаписи ### [](#%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D1%8B-%D0%B2%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D0%B5-%D0%BF%D0%BE%D1%82%D0%BE%D0%BA%D0%B8)Ресурсы (входящие потоки) #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B0-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2)Получение списка ресурсов Строка запроса **GET**: /api/v1/source ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0)Параметры запроса: *Параметры отсутствуют* ##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0)Варианты ответа: **Успешно** ``` [ { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "status": "Состояние доступности ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "basic или digest", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" } ] ``` #### [](#%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0)Создание ресурса **POST**: /api/v1/source ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-1)Параметры запроса:
ПараметрЗначениеОписание
**model**ТекстовыйМодель ресурса *Source* или *PictureSource*
descriptionТекстовыйОписание ресурса
**uri\_rtsp**Строка URIАдрес RTSP потока
uri\_http\_pictureСтруктураОписание скриншота камеры
uriСтрока URIАдрес получения изображения
authПеречисление*basic* или *digest*
userТекстовыйПользователь
passwordТекстовыйПароль
ffmpeg\_cmdТекстовыйШаблон команды транскодирования потока
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-1)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "status": "Состояние доступности ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" } ``` #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0)Получение ресурса **GET**: /api/v1/source/**{source\_id}**/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-2)Параметры запроса:
ПараметрЗначениеОписание
source\_idЧисловойИдентификатор ресурса *(часть запроса)*
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-2)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "status": "Состояние доступности ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" } ``` #### [](#%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0)Изменение ресурса **PUT**: /api/v1/source/**{source\_id}**/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-3)Параметры запроса:
ПараметрЗначениеОписание
source\_idЧисловойИдентификатор ресурса *(часть запроса)*
modelТекстовыйМодель ресурса
descriptionТекстовыйОписание ресурса
uri\_rtspТекствыйАдрес RTSP потока
uri\_http\_picture:Структура URI
uriТесктовыйАдрес получения изображения
authТекстовый*basic* или *digest*
userТекстовыйПользователь
passwordТекстовыйПароль
ffmpeg\_cmdТекстовыйШаблон команды транскодирования потока
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-3)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "status": "Состояние доступности ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" } ``` #### [](#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0)Удаление ресурса **DELETE**: /api/v1/source/**{source\_id}**/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-4)Параметры запроса:
ПараметрЗначениеОписание
source\_idЧисловойИдентификатор ресурса *(часть запроса)*
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-4)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "status": "Состояние доступности ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" } ``` #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BA%D1%80%D0%B8%D0%BD%D1%88%D0%BE%D1%82%D0%B0-%D0%BF%D0%BE%D1%82%D0%BE%D0%BA%D0%B0)Получение скриншота потока Строка запроса **GET**: /api/v1/source/**{source\_id}**/picture ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-5)Параметры запроса:
ПараметрЗначениеОписание
source\_idЧисловойИдентификатор ресурса *(часть запроса)*
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-5)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** *Данные изображения* #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BA%D1%80%D0%B8%D0%BD%D1%88%D0%BE%D1%82%D0%B0-%D0%BF%D0%BE%D1%82%D0%BE%D0%BA%D0%B0-1)Получение скриншота потока Строка запроса **GET**: /api/v1/source/**{source\_id}**/video ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-6)Параметры запроса:
ПараметрЗначениеОписание
source\_idЧисловойИдентификатор ресурса *(часть запроса)*
delayЧисловойЗадержка между кадрами в секундах, по умолчанию 1 секунда
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-6)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** *Данные видеопотока mJPEG* ### [](#%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D1%8C%D1%8E)Управление записью #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D1%8F-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2-%D0%BF%D0%BE-%D0%BC%D0%B5%D1%82%D0%BA%D0%B5)Получение состояния записи ресурсов по метке Строка запроса **GET**: /api/v1/record ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-7)Параметры запроса:
ПараметрЗначениеОписание
tag\_nameТекстовыйИдентификатор метки ресурсов
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-7)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` [ { "id": "Идентификатор записи", "created_utc": "Дата-время создания записи", "status": "Состояние записи", "begin_utc": "Дата-время начала записи", "end_utc": "Дата-время окончания записи", "source": [ { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "status": "Состояние доступности ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" } ], "hash_md5": "Контрольная сумма записи MD5", "location": "Путь хранения записи", "sync_location": "Пусть для синхронизации видеозаписи с другим видеосервером" } ] ``` #### [](#%D0%BE%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8-%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2-%D0%BF%D0%BE-%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%83-%D0%BC%D0%B5%D1%82%D0%BA%D0%B8)Остановка записи группы ресурсов по идентификатору метки **PUT**: /api/v1/record ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-8)Параметры запроса:
ПараметрЗначениеОписание
modelТекстовыйМодель метки записи ресурса для изменений *Source* или *PictureSource*
tag\_nameТекстовыйИдентификатор метки ресурсов
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-8)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** *Нет данных* #### [](#%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8-%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2-%D1%81-%D0%BC%D0%B5%D1%82%D0%BA%D0%BE%D0%B9)Запуск записи группы ресурсов с меткой **POST**: /api/v1/record ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-9)Параметры запроса:
ПараметрЗначениеОписание
modelТекстовыйМодель метки записи ресурса для изменений *Source* или *PictureSource*
tag\_nameТекстовыйИдентификатор метки ресурсов
group\_nameТекстовыйИдентификатор группы ресурсов
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-9)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** *Нет данных* #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D1%8F-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2-%D1%81-%D0%BC%D0%B5%D1%82%D0%BA%D0%BE%D0%B9)Получение состояния записи ресурсов с меткой Строка запроса **GET**: /api/v1/record/runing ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-10)Параметры запроса:
ПараметрЗначениеОписание
tag\_nameТекстовыйИдентификатор метки ресурсов
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-10)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** Значение *true* или *false* #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0)Получение записи ресурса Строка запроса **GET**: /api/v1/record/**{record\_id}**/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-11)Параметры запроса:
ПараметрЗначениеОписание
record\_idТекстовыйИдентификатор записи ресурса *(часть запроса)*
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-11)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор записи", "created_utc": "Дата-время создания записи", "status": "Состояние записи", "begin_utc": "Дата-время начала записи", "end_utc": "Дата-время окончания записи", "source": { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "status": "Состояние доступности ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" }, "hash_md5": "Контрольная сумма записи MD5", "location": "Путь хранения записи", "sync_location": "Пусть для синхронизации видеозаписи с другим видеосервером" } ``` #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%87%D0%B0%D1%81%D1%82%D0%B8-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8)Получение части файла записи Строка запроса **GET**: /api/v1/record/**{record\_id}**/video/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-12)Параметры запроса:
ПараметрЗначениеОписание
record\_idТекстовыйИдентификатор записи ресурса *(часть запроса)*
rangeЧисленный-ЧисленныйДиапазон байт для загрузки, параметр заголовка запроса
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-12)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** *Двоичные данные* #### [](#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0-%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8)Удаление файла видеозаписи **DELETE**: /api/v1/record/**{record\_id}**/file/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-13)Параметры запроса:
ПараметрЗначениеОписание
record\_idТекстовыйИдентификатор записи ресурса *(часть запроса)*
locationТекстовыйПуть к файлу видеозаписи
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-13)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор записи", "created_utc": "Дата-время создания записи", "status": "Состояние записи", "begin_utc": "Дата-время начала записи", "end_utc": "Дата-время окончания записи", "source": { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "status": "Состояние доступности ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" }, "hash_md5": "Контрольная сумма записи MD5", "location": "Путь хранения записи", "sync_location": "Пусть для синхронизации видеозаписи с другим видеосервером" } ``` ### [](#%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D0%B0%D0%BC%D0%B8-%D0%BA%D0%B0%D0%BC%D0%B5%D1%80)Управление группами камер #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%BD%D0%B8%D0%B5-%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B0-%D0%B3%D1%80%D1%83%D0%BF%D0%BF-%D0%BA%D0%B0%D0%BC%D0%B5%D1%80)Получние списка групп камер Строка запроса **GET**: /api/v1/group ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-14)Параметры запроса: *Параметры отсутствуют* ##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-14)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` [ { "id": "Идентификатор группы", "created_utc": "Дата-время создания группы", "name": "Имя группы" } ] ``` #### [](#%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2)Создание группы ресурсов **POST**: /api/v1/group ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-15)Параметры запроса:
ПараметрЗначениеОписание
modelТекстовыйМодель метки записи ресурса для изменений *Source* или *PictureSource*
nameТекстовыйНаименование группы
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-15)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` [ { "id": "Идентификатор группы", "created_utc": "Дата-время создания группы", "name": "Имя группы" } ] ``` #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D0%B9-%D0%BE-%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2)Получение сведений о группе ресурсов Строка запроса **GET**: /api/v1/group/**{group\_id}**/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-16)Параметры запроса:
ПараметрЗначениеОписание
group\_idТекстовыйИдентификатор группы ресурсов *(часть запроса)*
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-16)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор группы ресурсов", "сreated_utc": "Дата-время создания группы", "name": "Наименование группы", "sources": [ { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" } ] } ``` #### [](#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2)Удаление группы ресурсов **DELETE**: /api/v1/group/**{group\_id}**/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-17)Параметры запроса:
ПараметрЗначениеОписание
group\_idТекстовыйИдентификатор группы ресурсов *(часть запроса)*
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-17)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор группы ресурсов", "сreated_utc": "Дата-время создания группы", "name": "Наименование группы" } ``` #### [](#%D0%B4%D0%BE%D0%B1%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0-%D0%B2-%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%83-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2)Добавление ресурса в группу ресурсов **POST**: /api/v1/group/**{group\_id}**/source/**{source\_id}**/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-18)Параметры запроса:
ПараметрЗначениеОписание
group\_idТекстовыйИдентификатор группы ресурсов *(часть запроса)*
source\_idТекстовыйИдентификатор ресурса *(часть запроса)*
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-18)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** Значение *true* или *false* #### [](#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0-%D0%B8%D0%B7-%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2)Удаление ресурса из группы ресурсов **DELETE**: /api/v1/group/**{group\_id}**/source/**{source\_id}**/ ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-19)Параметры запроса:
ПараметрЗначениеОписание
group\_idТекстовыйИдентификатор группы ресурсов *(часть запроса)*
source\_idТекстовыйИдентификатор ресурса *(часть запроса)*
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-19)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** Значение *true* или *false*//\* ### [](#%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BC%D0%B5%D1%82%D0%BA%D0%B0%D0%BC%D0%B8-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B5%D0%B9)Управление метками записей #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BC%D0%B5%D1%82%D0%BA%D0%B8-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2)Получение метки записи ресурсов Строка запроса **GET**: /api/v1/tag ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-20)Параметры запроса:
ПараметрЗначениеОписание
nameТекстовыйНаименование метки
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-20)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** ``` { "id": "Идентификатор тега", "created_utc": "Дата-время создания тега", "name": "Имя тега", "records": [ { "id": "Идентификатор записи", "created_utc": "Дата-время создания записи", "status": "Состояние записи", "begin_utc": "Дата-время начала записи", "end_utc": "Дата-время окончания записи", "source": { "id": "Идентификатор ресурса", "created_utc": "Дата-время создания ресурса", "uri_rtsp": "Адрес RTSP потока", "uri_http_picture": { "uri": "Адрес получения изображения", "auth": "*basic* или *digest*", "user": "Пользователь", "password": "Пароль" }, "description": "Описание ресурса", "ffmpeg_cmd": "Шаблон команды транскодирования потока" }, "hash_md5": "Контрольная сумма записи MD5", "location": "Путь хранения записи", "sync_location": "Пусть для синхронизации видеозаписи с другим видеосервером" } ] } ``` #### [](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-%D0%BD%D0%B0%D1%87%D0%B0%D1%82%D1%8B%D0%B5-%D0%BC%D0%B5%D1%82%D0%BA%D0%B8)Получить начатые метки Строка запроса **GET**: /api/v1/tag/begin ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-21)Параметры запроса: *Параметры отсутствуют* ##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-21)Варианты ответа: **Успешно** ``` ["Наименование метки"] ``` ### [](#%D1%81%D0%B8%D0%BD%D1%85%D1%80%D0%BE%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85)Синхронизация данных #### [](#%D0%BD%D0%B0%D1%87%D0%B0%D1%82%D1%8C-%D1%81%D0%B8%D0%BD%D1%85%D1%80%D0%BE%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8E-%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE)Начать синхронизацию видео **POST**: /api/v1/sync ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-22)Параметры запроса:
ПараметрЗначениеОписание
tag\_nameТекстовыйНаименование метки
locationТекстовыйРасположение файла
##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-22)Варианты ответа: **Ошибка 422** ``` { "detail": [ { "loc": ["Положение ошибки"], "msg": "Сообщение ошибки", "type": "Тип ошибки" } ] } ``` **Успешно** *Строковые данные* ### [](#%D1%80%D0%B0%D0%B7%D0%BB%D0%B8%D1%87%D0%BD%D1%8B%D0%B5-%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BA%D0%B8)Различные проверки #### [](#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BA%D0%B0-%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F)Проверка изображения Строка запроса **GET**: /test/img ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-23)Параметры запроса: *Не имеет параметров* ##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-23)Варианты ответа: **Успешно** *Не имеет ответа* #### [](#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BA%D0%B0-%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE)Проверка видео Строка запроса **GET**: /test/video ##### [](#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0-24)Параметры запроса: *Не имеет параметров* ##### [](#%D0%B2%D0%B0%D1%80%D0%B8%D0%B0%D0%BD%D1%82%D1%8B-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0-24)Варианты ответа: **Успешно** *Не имеет ответа*