/api/usr/list
获取用户和分组列表
仅管理员分组有权限。
接口原型
| 协议 |
HTTP/HTTPS GET |
| URL |
ip[:port]/api/usr/list |
| 数据格式 |
响应消息：Content-Type: application/json |
请求URL参数
| 参数 |
描述 |
| type |
可选，限制获取的列表，usr为仅获取用户列表，group为仅获取分组列表，不填则获取所有 |
| id |
可选，当type为group时，可通过指定id返回对应id的组信息 |
| more |
可选，当设置为1时，用户组中的用户列表将得到更详细的信息 |
请求示例
GET /api/usr/list HTTP/1.1
Accept: application/json, text/plain, */*
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
响应参数
| 参数 |
描述 |
| Content-Type |
取值为：'application/json; charset=UTF-8' |
Response Body
分组列表
| 参数 |
描述 |
| name |
分组名 |
| id |
组id |
| desc |
描述 |
| permission |
权限掩码 |
| users |
数组形式的用户名称列表，如果more为1，则为数组形式的用户对象列表，用户对象结果中包含用户名成和id |
| type |
分组类型，1为admin，2为usr，4为viewer，8为自定义 |
用户信息
| 参数 |
描述 |
| name |
用户名 |
| id |
用户id |
| group-name |
分组名 |
| group-id |
分组ID |
| permission |
权限掩码 |
响应示例
{
"groups": [
{
"desc": "Administrator group",
"id": 1,
"name": "Admin",
"permission": 4294967295,
"type": 1,
"users": [
"Admin"
]
},
{
"desc": "User groups",
"id": 2,
"name": "User",
"permission": 57183,
"type": 2,
"users": [
"10"
]
},
{
"desc": "Viewer group",
"id": 4,
"name": "Viewer",
"permission": 57183,
"type": 4
}
],
"result": 0,
"users": [
{
"group-id": 1,
"group-name": "Admin",
"id": 1,
"name": "Admin",
"permission": 4294967295
},
{
"group-id": 2,
"group-name": "User",
"id": 4194304,
"name": "10",
"permission": 57183
}
]
}