Skip to main content
Skip table of contents

Обновление временного пользователя

Обновление временного пользователя

При обновлении пользователей параметры cameras_to_attach и cameras_to_detach нужно отправлять только тогда, когда что-то поменялось, и только те id камер, которые в данный момент добавили или удалили. При добавлении или удалении большого количества камер, необходимо будет отправить несколько запросов, потому что в одном запросе можно прислать только 500 камер

PUT api/admin/v1/special-users/{user}

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

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


string name, имя


string login, уникальный логин среди остальных администраторов


string password, пароль


string password_confirmation, повторный ввод пароля, чтобы убедиться, что пароль введен правильно


array permissions, массив id пермишенов


array cameras_to_attach, массив id камер, которые необходимо добавить пользователю. Максимум 500 элементов


array cameras_to_detach, массив id камер, которые необходимо удалить пользователю. Максимум 500 элементов


date expired_at, дата, до которой будет действовать временный пользователь


int ptz_priority, PTZ приоритет

200 OK

Возвращает объект временного пользователя

JSON
{
    "id": 117,
    "name": "user",
    "login": "user@mail.com",
    "created_at": "2022-05-11 18:40:46",
    "updated_at": "2022-05-11 18:40:46",
    "expired_at": null,
    "is_licence_limit_reached": false,
    "permissions": [
        {
            "id": 77,
            "name": "archives-preview-download",
            "display_name": "Сохранение скриншота камеры",
            "group": "Screenshots"
        },
        {
            "id": 149,
            "name": "packs-index",
            "display_name": "Просмотр списка групп медиасерверов",
            "group": "Группы медиасерверов"
        },
        {
            "id": 150,
            "name": "packs-show",
            "display_name": "Просмотр группы медиасервера",
            "group": "Группы медиасерверов"
        },
        {
            "id": 151,
            "name": "packs-store",
            "display_name": "Сохранение группы медиасерверов",
            "group": "Группы медиасерверов"
        },
        {
            "id": 152,
            "name": "packs-update",
            "display_name": "Обновление группы медиасервера",
            "group": "Группы медиасерверов"
        },
        {
            "id": 153,
            "name": "packs-destroy",
            "display_name": "Удаление группы медиасервера",
            "group": "Группы медиасерверов"
        }
    ],
    "ptz_priority": null,
    "admin_camera_groups": [],
    "dhcp_subnet_groups": [],
    "access_token_id": null
}

401 Unauthorized

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

402 Payment Required

Превышен лимит лицензий для выбранного кейса аналитики

422 Unprocessable Entity

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

JSON
{
    "message": "Тут не будет информативного сообщения",
    "errors": {
        "any_key": [
            "Тут будет описана причина ошибки"
        ]
    }
}
cURL
BASH
curl -k --request POST \
	--url 'https://your-domainapi/admin/v1/special-users/{user}' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "user": 0,
    "name": "string",
    "login": "string",
    "password": "string",
    "password_confirmation": "string",
    "permissions": [],
    "cameras_to_attach": [],
    "cameras_to_detach": [],
    "expired_at": "date",
    "ptz_priority": 0
}'
PHP
PHP
$data = array (
  'user' => 0,
  'name' => 'string',
  'login' => 'string',
  'password' => 'string',
  'password_confirmation' => 'string',
  'permissions' => 
  array (
  ),
  'cameras_to_attach' => 
  array (
  ),
  'cameras_to_detach' => 
  array (
  ),
  'expired_at' => 'date',
  'ptz_priority' => 0,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'PUT',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domainapi/admin/v1/special-users/{user}', false, $context);
JavaScript errors detected

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

If this problem persists, please contact our support.