# 获取用户权限列表 - getUserPermissionList
#### 功能介绍
获取用户权限列表
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/permission/userList
表1Query参数 
| 参数          | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| templateId  | 否    | String  | 权限模板id - -1：匿名模板   - 其他：一个命名模板的id    |
| spaceType   | 是    | Integer | 空间类型 - 0：部门   - 1：群组                 |
| groupId     | 否    | String  | 群组id(空间类型为1必传)                                                                                                                                                                                                                                                                                                                                                                                                   |
| deptId      | 否    | String  | 部门id(空间类型为0必传)                                                                                                                                                                                                                                                                                                                                                                                                   |
| count       | 否    | Integer | 返回数量（最大100）                                                                                                                                                                                                                                                                                                                                                                                                      |
| cursor      | 否    | String  | 游标，第一次不传（当第二次调时，从第一次返回体中获取，填入即可从第一次最后一个用户的下一个用户开始返回）                                                                                                                                                                                                                                                                                                                                                             |
| containerId | 是    | String  | 空间id                                                                                                                                                                                                                                                                                                                                                                                                             |
| userName    | 否    | String  | 用户名称                                                                                                                                                                                                                                                                                                                                                                                                             |
| fileId      | 否    | String  | 文件id                                                                                                                                                                                                                                                                                                                                                                                                             |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| Authorization | 是    | String | 1. 格式"Bearer {app_access_token}"，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取    |
| X-Traceid     | 否    | String | 消息日志跟踪标识（必须58位）                                                                                                                                                                                                                                                                       |
| language      | 否    | String | 国际化语言标识，符合i18n规范，如zh_cn表示简体中文，en_us表示美式英语                                                                                                                                                                                                                                             |
| X-User-Id     | 是    | String | 用户id，用于app鉴权                                                                                                                                                                                                                                                                          |
| X-Date        | 是    | String | 日期，用于app鉴权                                                                                                                                                                                                                                                                            |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                | 参数类型                                                                             | 描述     |
|:---|:---|:---|
| userPermissonList | Array of [userPermisson] objects | 用户权限列表 |
| code              | String                                                                           | 信息码    |
| msg               | String                                                                           | 信息     |
| nextCursor        | String                                                                           | 游标     |
   
 表4userPermisson 
| 参数           | 参数类型                                                                           | 描述                |
|:---|:---|:---|
| userName     | String                                                                         | 用户名称              |
| mobile       | String                                                                         | 手机号               |
| deptName     | String                                                                         | 部门名称              |
| deptId       | String                                                                         | 部门id              |
| templateId   | String                                                                         | 模板id              |
| groupName    | String                                                                         | 群组名称              |
| description  | String                                                                         | 匿名模板时返回的具体权限描述    |
| userId       | String                                                                         | 用户id              |
| templateName | String                                                                         | 模板名称              |
| deptRole     | Integer                                                                        | 部门角色（在传入的deptId下） |
| groupRole    | Integer                                                                        | 群组角色（在传入的group下）  |
| capabilities | Array of [Capabilities] objects | 权限值               |
   
 表5Capabilities 
| 参数                        | 参数类型    | 描述                             |
|:---|:---|:---|
| addChildNodePermission    | Boolean | 新建文件/文件夹权限；true有权限，false无权限。   |
| copyPermission            | Boolean | 复制权限；true有权限，false无权限。         |
| deletePermission          | Boolean | 删除权限；true有权限，false无权限。         |
| downloadPermission        | Boolean | 下载权限；true有权限，false无权限。         |
| editPermission            | Boolean | 编辑权限；true有权限，false无权限（暂不支持编辑）。 |
| listChildNodePermission   | Boolean | 可见列表权限；true有权限，false无权限。       |
| removeChildNodePermission | Boolean | 移动权限；true有权限，false无权限。         |
| renameFilePermission      | Boolean | 重命名权限；true有权限，false无权限。        |
| shareFilePermission       | Boolean | 分享权限；true有权限，false无权限。         |
| uploadPermission          | Boolean | 上传权限；true有权限，false无权限。         |
| viewPermission            | Boolean | 预览权限；true有权限，false无权限。         |
   
#### 请求示例
获取用户权限列表请求示例
```
/koodrive/ose/v1/permission/userList?spaceType=0&deptId=1570902*****4673&count=100&containerId=IAAFW*******054209
Authorization:Bearer+7b8d5d009443187d149432249b2482fbc87d1be0c1dd3f6f
```
#### 响应示例
**状态码：200**
获取用户权限列表响应
```
{
  "userPermissionList" : [ {
    "userName" : "111",
    "userId" : "15842******45888",
    "mobile" : "0086137****6060",
    "deptName" : "ce**i-1",
    "templateId" : "1568195451952301579",
    "capabilities" : {
      "addChildNodePermission" : true,
      "copyPermission" : true,
      "deletePermission" : false,
      "downloadPermission" : true,
      "editPermission" : true,
      "listChildNodePermission" : true,
      "removeChildNodePermission" : true,
      "renameFilePermission" : true,
      "shareFilePermission" : true,
      "uploadPermission" : true,
      "viewPermission" : true
    },
    "templateName" : "仅不可删除",
    "deptRole" : 1
  } ],
  "code" : 0,
  "msg" : "成功"
}
```
#### 状态码
| 状态码 | 描述         |
|:---|:---|
| 200 | 获取用户权限列表响应 |