Request Parameters
Request does not contain parameters.
Request Example
http://192.168.1.1:9080/api/admins/list.ds
|
XML and JSON response structure examples are described below.
XML Response
<drweb-es-api api_version="4.3.0" timestamp="1558521888" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<adm1inistrators total="2">
<administrator id="1" login="adm1" group_id="b3c14d40" group_name="Administrators" may_create_admin="true" permission="allow"/>
<groups>
<group id="GroupForCAF1-1">GroupForCAF1-1</group>
<group id="GroupForCAF1-2">GroupForCAF1-2</group>
</groups>
</administrator>
<administrator id="2" login="adm2" group_id="b3c14d40" group_name="Administrators" may_create_admin="false" permission="deny"/>
<groups> </groups>
</administrator>
</administrators>
</drweb-es-api>
|
Description of XML Response Parameters
The <administrators /> element contains a list of administrators in all administrator groups.
The <administrators /> element attribute:
Attribute
|
Description
|
total
|
Total number of administrators
|
•The <administrator /> element contains information about a specific administrator account. The <administrator /> element attributes:
Attribute
|
Description
|
group_id
|
Administrative group identifier
|
group_name
|
Administrative group name
|
id
|
Account identifier
|
login
|
Account login
|
may_create_admin
|
Right to create other group administrators
|
permission
|
Granting access privileges. May take the following values:
•allow—access allowed •deny—access denied. |
▫The <groups /> element contains information about all user groups that the administrator manages. The <groups /> element attributes:
Attribute
|
Description
|
total
|
Total number of user groups
|
▪The <group /> element contains information on a specific user group. The <group /> element attribute:
Attribute
|
Description
|
id
|
User group identifier
|
The <group /> element value is the user group name.
JSON Response Structure
{ "head": {
"status": true,
"timestamp": 1551398630,
"api": {
"version": 40300,
"versionString": 4.3.0},
"server": {
"name": "192.168.1.1",
"version": "12.00.0.201909260",
"uuid": "20546124-e03f-e411-0aa6-a4d5c8ad7f2c"}},
"data": {
"total": 2,
"list": [
{"group_id": "b3c14d40"
"group_name": "Administrators",
"groups": {
"GroupForCAF1-1": "GroupForCAF1-1",
"GroupForCAF1-2": "GroupForCAF1-2"},
"id": "1",
"login": "adm1",
"may_create_admins": true,
"permission": "allow"},
{"group_id": "b3c14d40"
"group_name": "Administrators",
"groups": [],
"id": "2",
"login": "adm2",
"may_create_admins": false,
"permission": "deny"}]}}
|
Description of JSON Response Parameters
The data block contains a list of administrators in all administrator groups.
The data block elements:
Field name
|
Description
|
total
|
Total number of administrators
|
•The list array of the data block contains information about a specific administrator account. Elements in the list array:
Field name
|
Description
|
id
|
Account identifier
|
login
|
Account login
|
group_id
|
Administrative group identifier
|
group_name
|
Administrative group name
|
may_create_admins
|
Right to create other group administrators
|
permission
|
Granting access privileges. May take the following values:
•allow—access allowed •deny—access denied. |
▫The groups element contains information about all user groups that the administrator manages. The groups block elements:
Field name
|
Description
|
User group identifier
|
User group name
|
|