Управлeние камерами

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

POST /api/v1/billing/user/manage/cameras

Синхронизирует камеры пользователя по его логину.

Выделить доступ к камерам можно несколькими способами:

Без указания дополнительных параметров (при данной синхронизации установленные параметры останутся прежними):

JSON

{
    "login": "test@mail.com",
    "camera_ids": [
        3,
        4
    ],
    "camera_external_ids": [
        "00000000-0000-0000-0000-000000000050",
        "00000000-0000-0000-0000-000000000051"
    ],
    "public_group_external_ids": [
        "df2f2f7a-ecd6-4ffd-8a23-6880b803d23a"
    ],
    "private_group_external_ids": [
        {
            "key": "test",
            "group_external_id": "df2f2f7a-ecd6-4ffd-8a23-6880b803d23a"
        }
    ]
}

С указанием дополнительных параметров для камеры:

JSON

{
    "login": "test@mail.com",
    "camera_ids": [
        {
            "camera_id": 3,
            "status": "active"
        },
        {
            "camera_id": 4,
            "status": "blocked"
        },
        {
            "camera_id": 5,
            "status": "blocked"
        }
    ],
    "camera_external_ids": [
        {
            "external_id": "00000000-0000-0000-0000-000000000050",
            "status": "active"
        },
        {
            "external_id": "00000000-0000-0000-0000-000000000051",
            "status": "blocked"
        }
    ],
    "public_group_external_ids": [
        {
            "external_id": "df2f2f7a-ecd6-4ffd-8a23-6880b803d23a",
            "status": "blocked"
        }
    ],
    "private_group_external_ids": [
        {
            "key": "folder 1",
            "group_external_id": "df2f2f7a-ecd6-4ffd-8a23-6880b803d23a",
            "status": "active"
        },
        {
            "key": "folder 2",
            "group_external_id": "df2f2f7a-ecd6-4ffd-8a23-6880b803d23a",
            "status": "blocked"
        }
    ]
}

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

string login – логин пользователя.

array camera_ids – список идентификаторов камер из базы данных VMS.

array camera_external_ids – список идентификаторов камер, которые указали при создании камеры.

array public_group_external_ids – список идентификаторов публичных групп камер.

array private_group_external_ids – список идентификаторов приватных групп камер.

object array

string|int private_group_external_ids. REQUIREDgroup_external_id Идентификатор приватной группы камер

204 No Content

Успешный ответ

422 Unprocessable Entity

Возвращает JSON объект с ошибкой. Детально в разделе Общая информация→Валидация.

JSON

{
    "message": "Тут не будет информативного сообщения",
    "errors": {
        "any_key": [
            "Тут будет описана причина ошибки"
        ]
    }
}

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/v1/billing/user/manage/cameras' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "login": "string",
    "camera_ids": [],
    "camera_external_ids": [],
    "public_group_external_ids": [],
    "private_group_external_ids": {
        "": "string|int"
    },
    "private_group_external_ids.": "void"
}'

PHP

$data = array (
  'login' => 'string',
  'camera_ids' => 
  array (
  ),
  'camera_external_ids' => 
  array (
  ),
  'public_group_external_ids' => 
  array (
  ),
  'private_group_external_ids' => 
  array (
    '' => 'string|int',
  ),
  'private_group_external_ids.' => 'void',
);
$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/user/manage/cameras', false, $context);