Параметры запроса
Параметр |
Описание |
Обязательный |
|---|---|---|
add-group |
Идентификатор группы, к которой получит доступ администратор. Параметр может быть указан в запросе неограниченное количество раз для указания нескольких групп одновременно. |
нет |
delete-group |
Идентификатор группы, к которой будет отменен доступ администратору. Параметр может быть указан в запросе неограниченное количество раз для указания нескольких групп одновременно. |
нет |
description |
Описание |
нет |
id |
Идентификатор учетной записи администратора, параметры которой будут изменены |
да |
last-name |
Фамилия |
нет |
login |
Регистрационное имя учетной записи администратора |
нет |
may-create-admin |
Наличие права на создание учетных записей администраторов, групп администраторов. Допустимые значения: yes | no. По умолчанию: yes. |
нет |
middle-name |
Отчество |
нет |
name |
Имя |
нет |
password |
Пароль |
нет |
readonly |
Ограничение прав учетной записи администратора. Допустимые значения: yes | no. По умолчанию: no. Если задано значение yes, то администратор будет иметь право только на чтение (см. Приложение А2. Права администратора). |
нет |
|
Если одновременно заданы параметры readonly=yes и may-create-admin=yes, то параметр readonly является приоритетным. Т. е. администратор с правами только на чтение не может создавать или изменять настройки учетных записей других администраторов.
Администратор не может изменять параметры may-create-admin, readonly и group для своей учетной записи. |
Пример запроса
https://192.168.1.1:9081/api/admins/change.ds?id=adm3&login=newadm3&password=root&name=name&last-name=last-name&middle-name=middle-name&description=description&add-group=1&readonly=yes&may-create-admin=no |
Ниже представлены примеры ответов в формате XML и в формате JSON.
<drweb-es-api api_version="4.3.2" timestamp="1582030255" server="192.168.1.1" srv_version="13.00.1.202310121" status="true"> <administrator id="adm3"/> </drweb-es-api> |
Описание параметров ответного XML
Элемент <administrator /> содержит идентификатор измененной учетной записи администратора.
Атрибут элемента <administrator />:
Атрибут |
Описание |
|---|---|
id |
Идентификатор учетной записи |
{ "head": { "status": true, "timestamp": 1582030515, "api": { "version": 40302, "versionString": "4.3.2"}, "server": { "name": "192.168.1.1", "version": "13.00.1.202310121", "uuid": "eae1a652-96d5-48fd-9169-4788a03688b8"}}, "data": { "id": "adm3"}} |
Описание параметров ответного JSON
Блок data содержит идентификатор измененной учетной записи администратора.
Элемент блока data:
Название поля |
Описание |
|---|---|
id |
Идентификатор учетной записи |