# Сервис видеозаписи
Данная модель описывает 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)Варианты ответа:
**Успешно** *Не имеет ответа*