
# 查询部门空间列表信息 - GetDepartmentSpaceList
#### 功能介绍
查询部门空间列表信息。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/space/departmentList
表1Query参数 
| 参数      | 是否必选 | 参数类型   | 描述                                   |
|:---|:---|:---|:---|
| offset  | 是    | String | 偏移量，最小值为0                            |
| limit   | 是    | String | 最大返回个数。最小值为1，最大值为100                 |
| keyWord | 否    | String | 搜索的关键字，可用name和Administrator作为关键字搜索条件 |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                            |
|:---|:---|:---|:---|
| Authorization | 是    | String | 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} |
| 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                                                                                        | 错误信息   |
| total       | String                                                                                        | 总数     |
| departments | Array of [departmentSpaceInfo] objects | 部门空间信息 |
   
 表4departmentSpaceInfo 
| 参数       | 参数类型   | 描述              |
|:---|:---|:---|
| id       | String | 部门ID            |
| parentId | String | kooDrive中的父部门ID |
| name     | String | 部门名称            |
| tenantId | String | 租户标识            |
   
#### 请求示例
查询部门空间列表，每次查询10个。
```
GET /koodrive/cloudfile/v1/space/departmentList?offset=0&limit=10
Authorization:Bearer+10f88**********4791e9ff
```
#### 响应示例
**状态码：200**
部门空间列表信息。
```
{
  "total" : 364,
  "departments" : [ {
    "tenantId" : "40086000004871666",
    "creator" : "369528171409614001",
    "createTime" : "2023-11-14T20:39:06.000Z",
    "modifier" : "369528171409614001",
    "updateTime" : "2023-12-26T11:40:08.000Z",
    "ownerId" : "1289173668999530369",
    "status" : 0,
    "capacity" : 1,
    "spaceUsed" : 654777,
    "containerId" : "IAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b",
    "bizRootFileId" : "DEUI7pa0C24ArootIAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b",
    "bizSboxFileId" : "DEUI7pa0C24AsboxIAADfsBFCO6WtAtuAb7e92cde625843cfb7f4ceba802e0b",
    "id" : "1289173668999530369",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953477584",
    "userNum" : 1
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173650183882753",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953475619"
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173631275960193",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953473454"
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173612200265729",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953470101"
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173593258788737",
    "parentId" : "1289171275545118721",
    "name" : "部门169995346896"
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173574392809473",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953466973"
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173555140953985",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953463567"
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173535931041664",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953461741"
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173517174114305",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953459399"
  }, {
    "tenantId" : "40086000004871666",
    "id" : "1289173498115196929",
    "parentId" : "1289171275545118721",
    "name" : "部门1699953457405"
  } ],
  "code" : 0,
  "msg" : "成功"
}
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | 部门空间列表信息。 |
   
