# 获取用户空间列表 - GetUserSpaceList
#### 功能介绍
查询部门下用户空间列表信息。当未传入department_id时，查询当前登录用户所在组织的用户空间列表。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/space/userList
表1Query参数 
| 参数          | 是否必选 | 参数类型    | 描述                                                    |
|:---|:---|:---|:---|
| deptId      | 否    | String  | 部门标识。当未传值时，系统管理员用户查询当前组织下的用户空间列表，部门管理员用户查询所在部门的用户空间列表 |
| isDirect    | 否    | Boolean | 是否为直属用户，默认为false                                      |
| offset      | 是    | String  | 偏移量，最小值为0                                             |
| limit       | 是    | String  | 最大返回个数。最小值为1，最大值为100                                  |
| keyWord     | 否    | String  | 搜索的关键字，可用name和mobile作为关键字搜索条件。                        |
| spaceStatus | 否    | String  | 空间状态                                                  |
   
#### 请求参数
表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参数 
| 参数    | 参数类型                                                                        | 描述     |
|:---|:---|:---|
| code  | Integer                                                                     | 响应码    |
| msg   | String                                                                      | 响应消息   |
| users | Array of [userSpaceInfo] objects | 用户空间信息 |
| total | String                                                                      | 总数     |
   
 表4userSpaceInfo 
| 参数          | 参数类型    | 描述     |
|:---|:---|:---|
| name        | String  | 用户名称   |
| deptId      | String  | 部门标识   |
| deptName    | String  | 部门名称   |
| mobile      | String  | 手机号    |
| role        | Integer | 用户角色   |
| status      | Integer | 用户账号状态 |
| containerId | String  | 空间标识   |
| capacity    | Long    | 个人空间大小 |
| spaceUsed   | Long    | 已用空间大小 |
| tenantId    | String  | 租户id   |
| id          | String  | 用户空间id |
| userId      | String  | 用户id   |
| spaceStatus | String  | 空间状态   |
   
#### 请求示例
获取本部门的用户空间列表信息。
```
GET /koodrive/ose/v1/space/userList?deptId=&isDirect=&offset=0&limit=100&keyWord
Authorization:Bearer+10f88**********4791e9ff
```
#### 响应示例
**状态码：200**
用户空间列表信息
```
{
  "total" : 1,
  "users" : [ {
    "tenantId" : "cad444830661464d9da88784a96d960c",
    "status" : 0,
    "capacity" : 10,
    "spaceUsed" : 189,
    "containerId" : "IAAE49hOR8LulgAAA1410765425310141185",
    "id" : "1410765364786334592",
    "role" : 1,
    "name" : "xx",
    "deptName" : "xxx",
    "userId" : "1008600000445114904",
    "deptId" : 1410183811475666000,
    "mobile" : "0086147****6900",
    "spaceStatus" : "0"
  } ],
  "code" : 0,
  "msg" : "成功"
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 用户空间列表信息 |