Skip to main content
Skip table of contents

Пoлучение плoскoго дерева камер пользователя

Получение плоского дерева камер

С помощью параметра has_cameras можно понять, содержит ли группа камеры.

Если у пользователя есть бриджи c камерами, то у него добавятся папки, которые будут называться так же как и бридж. Для получения камер внутри необходимо делать отдельный запрос описанный ниже. Поле id групп, может быть как int, так и string.

Для получения списка камер из конечной группы необходимо использовать запрос на список камер в группе, с указанием параметра group_id и параметра search в случае, если ранее по дереву камер осуществлялся поиск VMS Client/Камеры клиента/Общие запросы/Список камер в группе клиента.

GET /api/v2/cameras/flat-tree

Параметры метода

string search – поиск по адресу и названию камеры.

int page – номер страницы пагинации.

int per_page – Количество элементов на одной странице пагинации. По умолчанию 10 элементов.

200 OK

Возвращает JSON объект дерева одного уровня вложенности

JSON
{
    "data": [
        {
            "id": -54,
            "name": "name",
            "cameras": [
                {
                    "id": 7631,
                    "is_bridge": true,
                    "status": "active",
                    "preview": "https://localhost:80/live/bc0d209e-8449-4c92-8c34-9e12660b8599/preview.mp4?token=sUuW0DWC4pYZJFzJh",
                    "user_status": "active",
                    "is_favorite": false,
                    "is_restricted_live": false,
                    "name": "домофон 3"
                }
            ],
            "full_address": "name"
        },
        {
            "id": -55,
            "name": "name",
            "cameras": [
                {
                    "id": 7632,
                    "is_bridge": true,
                    "status": "active",
                    "preview": "https://localhost:80/live/bc0d209e-8449-4c92-8c34-9e12660b8599/preview.mp4?token=sUuW0DWC4pYZJFzJh",
                    "user_status": "active",
                    "is_favorite": false,
                    "is_restricted_live": false,
                    "name": "домофон 3"
                }
            ],
            "full_address": "name"
        },
        {
            "id": 8,
            "name": "Тестовые камеры, домофоны",
            "cameras": [
                {
                    "id": 7680,
                    "is_bridge": false,
                    "status": "active",
                    "preview": "https://localhost:80/live/bc0d209e-8449-4c92-8c34-9e12660b8599/preview.mp4?token=sUuW0DWC4pYZJFzJh-b",
                    "user_status": "active",
                    "is_favorite": false,
                    "is_restricted_live": false,
                    "name": "issue_cam"
                }
            ],
            "full_address": "Тестовые камеры, домофоны"
        }
    ],
    "links": {
        "first": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=1",
        "last": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=3",
        "prev": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=1",
        "next": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=3"
    },
    "meta": {
        "current_page": 2,
        "from": 4,
        "last_page": 3,
        "links": [
            {
                "url": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=1",
                "label": "« Previous",
                "active": false
            },
            {
                "url": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=1",
                "label": "1",
                "active": false
            },
            {
                "url": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=2",
                "label": "2",
                "active": true
            },
            {
                "url": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "http://localhost:80/api/v2/cameras/flat-tree?per_page=3&page=3",
                "label": "Next »",
                "active": false
            }
        ],
        "path": "http://localhost:80/api/v2/cameras/flat-tree",
        "per_page": 3,
        "to": 6,
        "total": 9
    }
}

401 Unauthorized

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

422 Unprocessable Entity

Возвращает JSON объект с ошибкой.

JSON
{
    "message": "Тут не будет информативного сообщения",
    "errors": {
        "any_key": [
            "Тут будет описана причина ошибки"
        ]
    }
}
cURL
BASH
curl -k --request POST \
	--url 'https://your-domain/api/v2/cameras/flat-tree' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "search": "string",
    "page": 0,
    "per_page": 0
}'
PHP
PHP
$data = array (
  'search' => 'string',
  'page' => 0,
  'per_page' => 0,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'GET',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/v2/cameras/flat-tree', false, $context);
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.