Добавление устройства Bridge

Добавление бриджа

Permission - bridges

JSON

{
    "name": "bridge_1",
    "mac": "08:13:c0:00:00:82",
    "serial_number": "serial_number"
}

POST /api/admin/v1/bridges/users/{user}

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

int user, Уникальный идентификатор пользователя

string name, Имя устройства

string mac, MAC-адрес устройства. Обязательный без серийного номера. Уникальный среди устройств, добавленных пользователем

string serial_number, Серийный номер устройств. Обязательный без MAC-адреса

200 OK

Возвращает объект бриджа

JSON

{
    "id": 1,
    "serial_number": "12345678",
    "mac": "00-B0-D0-63-C2-26",
    "name": "bridge_1",
    "version": "1.0.1",
    "created_at": "2023-09-18T17:34:29.000000Z",
    "last_updated_at": "2023-09-18T17:34:54.000000Z",
    "is_online": true,
    "user": {
        "id": 1,
        "name": "admin",
        "login": "admin@mail.com",
        "created_at": "2023-07-17T13:21:16.000000Z",
        "cameras_count": null
    },
    "storages": [
        {
            "id": 2,
            "path": "/storage",
            "usage": 54.835,
            "capacity": 1024
        }
    ]
}

401 Unauthorized

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

403 Forbidden

Если у администратора или пользователя (для которого активируется бридж) отсутствуют необходимые права доступа

422 Unprocessable Entity

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

JSON

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

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/admin/v1/bridges/users/{user}' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "user": 0,
    "name": "string",
    "mac": "string",
    "serial_number": "string"
}'

PHP

$data = array (
  'user' => 0,
  'name' => 'string',
  'mac' => 'string',
  'serial_number' => 'string',
);
$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/admin/v1/bridges/users/{user}', false, $context);