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

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

POST /api/v1/billing/cameras/preview

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

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

JSON

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

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

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

string source REQUIRED – тип ссылки.

mp4 – превью в формате короткого MP4 фрагмента (значение по умолчанию).
jpg – изображение-превью в формате JPG.

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

200 OK

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

JSON

[ { "url": "http://127.0.0.1/test", "expired_at": "2000-01-01T00:00:00.000000Z" } ]

401 Unauthorized

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

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/v1/billing/cameras/preview' \
	--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/preview', false, $context);