URL для просмотра Live- и Archive-видео камер

Метод и параметры

POST /api/v1/billing/cameras/video

Если архивная ссылка содержит поле move_to, это значит, что архив был запрошен на время до начала самого архива. Чтобы избежать ошибки при просмотре, система автоматически сдвигает запрошенное время на дату из move_to.

Поле expired_at указывает, до какого момента ссылка действительна — после этой даты токен ссылки станет недействительным.

Также, при запросе можно передать интеграционный токен пользователя. Если у пользователя есть доступ к этой камере, будет сгенерирована рабочая ссылка на архив.

JSON

{
    "cameras": [
        {
            "uuid": "uuid",
            "stream_type": "high",
            "archive_ranges": true,
            "date": "2000-01-01T00:00:00Z"
        }
    ],
    "source": "hls",
    "ttl": "100"
}

array cameras REQUIRED – массив ID камер, для которых необходимо получить ссылки. У каждого объекта есть свойства:

uuid – UUID камеры, для которой надо сгенерировать ссылку. Поле обязательно.
stream_type – тип видео потока. Если его не передавать или в значении указать camera, то ссылка будет сгенерирована для камеры. Если передать, то ссылка будет сгенерирована для указанного потока камеры.
archive_ranges – данный флаг используется для добавления информации о диапазонах доступного архива.
date – данное поле для формирования архивной ссылки, указывается дата начал архива.

string source REQUIRED – тип протокола.

hls – HTTP Live Streaming (значение по умолчанию).
rtsp – Real Time Streaming Protocol.

int ttl – время жизни ссылки в секундах.

200 OK

Успешный ответ со всеми параметрами

JSON

[
{
"url": "http://127.0.0.1/test",
"url_type": "camera"
"expired_at": "2000-01-01T00:00:00.000000Z",
"archive_ranges": [
{
"from": "2000-01-01T00:00:00.000000Z",
"to": "2000-01-01T02:00:00.000000Z"
}
],
"move_to": "2000-01-01T00:00:00.000000Z"
}
]

401 Unauthorized

Если передан токен авторизации и он неверный

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/v1/billing/cameras/video' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "cameras": [],
    "source": "string",
    "ttl": 0
}'

PHP

$data = array (
  'cameras' => 
  array (
  ),
  'source' => 'string',
  'ttl' => 0,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'POST',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/v1/billing/cameras/video', false, $context);